Docs / Get started
Desktop app
The Pangea Mac app: panes, the in-app browser, remote desktops, the Inbox, artifacts, dashboards, designs, updates and languages.
The Mac app is where most work in Pangea happens. Download it from www.pangea.build/download. This page covers what the app adds around the chat with your agent.
The workspace
Each chat sits in a pane. Drag a chat from the sidebar onto the edge of a pane to split the window. ⌘J opens and closes the workspace panel, also called the dock. It holds the chat's browser tabs, its desktop, terminals, artifacts and other tools. ⌘K opens search across agents and people. ⌘B shows or hides the sidebar.
Browser
Open web pages in a Browser tab next to the chat instead of switching windows. When the agent needs a website or a sign-in page, it opens it in that chat's dock with local_browser. You watch the page it drives and type any password yourself.
- Each chat's agent sees only its own tabs. Agents can't see tabs you open by hand. Sign-ins are shared across tabs.
- Network recording. The agent can record a tab's network traffic as a HAR file to debug a page. The file stays on your Mac, readable only by your user, and is deleted after a day. It holds live cookies, so treat it as a secret.
- Open links in Pangea. Pangea appears in macOS's default web browser list. If you choose it, web links open in a workspace tab.
Remote desktops
Every cloud computer has its own desktop. Open it from a chat's dock, or choose Open desktop from the computer's menu under Settings → Computers, to watch the agent work.
You can also watch and control a desktop from the iOS app, including your Mac's own screen while Pangea is open on it. Only you can open it, from a phone signed in to the same account. macOS asks once for Screen Recording and Accessibility access, and the Mac shows a notice while your phone has control.
Inbox
The Inbox collects everything waiting on you: questions and decisions from your agents, and teammates' requests to use your shared computer. Open an entry to answer its question cards without reading the whole transcript, or choose Open agent conversation to go to the chat.
Inside a chat, ⌘I opens the summary panel. Its Needs your input list shows the open questions of the chat and its sub-agents.
Artifacts, dashboards and designs
- Artifacts. An agent can show a document, a single-page HTML app, an SVG diagram or a code file as an artifact instead of pasting its source. It opens in the dock with its versions, a preview and the code. You can copy it, download it, or share it with your team.
- Dashboards. A team's Dashboards page holds panels the agent builds from your connected accounts. Each panel's menu has Ask agent, which starts a chat about that panel.
- Designs. A team's Designs page is a canvas of live HTML screens for desktop, tablet or phone. Ask the agent to "design a booking flow" and it builds the screens while the canvas is open. Press Play to click through the flow. Edits from you, teammates and the agent show up within seconds.
Updates
The app updates itself. Settings → This computer → Updates shows the update status and download progress, with a button to restart into the new version.
Language
Choose the app's language under Settings → This computer → Appearance → Language: English, Traditional Chinese (Taiwan), Simplified Chinese, Japanese, Korean, Thai, Indonesian or Spanish. Without a choice, the app follows your system language if it is one of these, and otherwise uses English. Messages to and from the agent are not translated.
Terminals and moving sessions
Open a terminal in the dock for a development server or an interactive shell that you and the agent both use. Closing its tab ends the shell. For short commands with an exit status, the agent uses local commands.
A session's runtime picker moves future work to a different computer or runtime. Read its confirmation and prepare files on the new computer. The transcript, browser sign-ins and the computer's disk are different kinds of state. A move does not copy all three. See Agents and shared sessions.