Skip to main content
Install Mains and sign in to at least one agent. Then choose the kind of work you want to do.
1

Choose a Code space

Select an agent from the space picker and choose Code. All four providers support this mode.
2

Add your repository

Click Add Project or press ⌘N. Add a local repository, clone a Git URL, or create a new repository.Mains uses your checkout by default. Enable Settings → Git → Worktrees when you want separate working directories for parallel tasks.
3

Give the agent a task

Open the workspace and send a prompt such as “Fix the login error and run the relevant tests.” Use @ to attach files or issues.
4

Review the changes

Open Changes to inspect the current uncommitted diff. Leave comments on lines or ranges, then send a follow-up to the agent. A turn’s change card also lets you review that turn’s patch.
5

Commit and open a pull request

Open the session panel. Use Commit or push, then Create pull request. Review generated text before submitting. PR creation needs authenticated gh.

​
Write a page instead

Open Atlas, choose Start a page, finish the “Create a page about…” prompt, and send it. You and the agent can then edit the Page together.

​
Keep a run moving

Answer approvals when an agent needs input. Switching chats does not stop a running task. Codex also supports queued messages and steering, and experimental voice conversations.