Skip to main content
Mains is designed around a repeatable workflow: pick a task, spin up an isolated workspace, let an agent implement it, review the changes, and merge. Here’s how the pieces fit together.

​
1. Pick a Task

Start from an issue or task in your project management tool. If you’ve connected GitHub, GitLab, Linear, Jira, Asana, Trello, or Sentry, your issues are already synced and searchable inside Mains.

​
2. Create a Workspace

Press Cmd+N to create a new workspace. Import a repository from a remote URL or a local path. Mains creates an isolated Git worktree automatically — your changes won’t interfere with other workspaces or branches. If a project already exists for the repository, the new workspace is added to it. Otherwise, Mains creates a project automatically based on the remote origin. Link the issue to your workspace so the agent has the full context — title, description, labels, and comments from the source. You can also select files from the file explorer to give the agent a more targeted view of the codebase.

​
4. Run the Agent

Type your goal in the workspace input and let the agent work. It will read files, run commands, write code, and track every change. You can watch progress in real time through the workspace events timeline. Claude Code, GitHub Copilot, and OpenAI Codex agents are all supported. Each workspace session runs in isolation, so you can run multiple sessions in parallel.

​
5. Review Changes

Open the diff viewer to see every file the agent modified. Green lines show additions, red lines show removals. For a deeper inspection, request a code review. The agent will produce structured findings with severity ratings, file locations, and suggested fixes.

​
6. Commit & Create a PR

Once you’re happy with the changes, commit directly from the diff viewer. Mains suggests a commit message based on the session context. Push the branch and open a pull request — all without leaving the app.

​
7. Archive

After merging, archive the workspace. Archived workspaces are hidden from the sidebar by default but remain accessible if you need to revisit them later. The worktree is cleaned up to free disk space.