Docs / Get started
Quickstart
Run your first coding task in Pangea, then bring in teammates and the tools you need.
Start with a repository or folder you already have. A cloud account is optional.
1. Sign up and install
Sign up at app.pangea.build with Google, Apple or an email code. Create a team or join the one you were invited to. Then download the Mac app from www.pangea.build/download and sign in.
2. Choose where the agent runs
To use a coding agent already installed on your Mac, open Settings → This computer → Local runtime. Pick a runtime, such as Claude Code or Codex, and follow its sign-in steps.
To work remotely, a team Administrator opens Settings → Computers and chooses Add computer:
- Pangea cloud computer: a computer Pangea runs for your team. Cloud computers come with your plan.
- Your own computer: a laptop or server you run, connected with a one-time command.
3. Start your first task
Choose New agent and pick the runtime in the composer. For a local runtime, point it at a folder on that computer:
Work in ~/code/my-app. Read the README, explain how to run the project, and find one small improvement. Show me the change before you commit anything.
Replace the path with your own. On a cloud or remote computer, clone the repository there first. A path on your laptop is not a path on the remote machine.
4. Follow and steer the work
The transcript shows progress and tool results. Send a message while the agent works to steer it. Answer question cards when it needs input. Stop the turn if you need it to halt.
Start in Auto Mode: actions the runtime considers risky ask for your approval first. A code edit does not need an infrastructure plan. Ask for a review before committing or publishing if that is how you work.
5. Bring your team and tools
Share the session when you want a teammate to read or help. The teammate also needs access to the computer where the work runs.
Connect GitHub, Linear or another connector when you need it, then select it for the session. For cloud work, add AWS or Google Cloud with only the permissions the task needs.
Keep working after you close your laptop
A local runtime needs your Mac and Pangea to stay on. For work that must keep going, move the session to a cloud computer or your own server with the session's runtime picker. Read the move confirmation and prepare the repository on the new computer. Conversation history does not copy files.
Next, read the Desktop guide, Agents and shared sessions, permission modes and plans. Add triggers when you are ready for scheduled work.