Multi-Workspace Development

Multi-workspace development lets you keep several coding tasks alive at once without mixing terminals, agents, files, or review notes. Each workspace is a focused place for one goal.

Why it matters

• Run agents on different branches in parallel.
• Keep experiments away from your main project folder.
• Switch tasks without closing terminals or losing session state.
• Match one workspace to one goal, such as fix-login or docs-refresh.

How It Works

Atmos creates a separate working folder for each workspace when your project uses Git. That lets multiple workspaces share the same repository while staying on different branches.

Each workspace keeps its own terminal, editor tabs, diff, agent history, and review state.

Get started

1. Open Atmos and choose New Workspace.
2. Pick a project folder or repository.
3. Select or create the branch for this task.
4. Name the workspace after the work you are doing.
5. Open the terminal or agent panel and start.

Tips

• Prefer one workspace per task; archive or close when shipped.
• Use short, searchable names so Kanban and search stay useful.
• For large efforts, split planning, implementation, and review across workspaces.