Overview
Each workspace is an isolated git worktree with its own branch. This means multiple agents can work on different features simultaneously without conflicts.Creating Workspaces
Create workspaces in three ways:- From scratch —
Cmd+N, name it, and write an initial prompt - From a Linear issue — Select a Linear issue and Commander creates a workspace linked to it
- From a pull request — Provide a PR URL and Commander checks out the branch
Setup Scripts
Configure per-repository setup scripts that run when a workspace is created:- Dependency installation (
pnpm install) - Database migrations
- Code generation
- Any custom setup commands
Git Integration
Commander polls git status for each workspace:- Files changed — Modified, added, deleted, renamed
- Ahead/behind — Commits ahead of and behind the base branch
- Conflicts — Merge conflict detection
- Staged/unstaged — Separate tracking for staging area
Linking
Workspaces can be linked to:- GitHub Pull Requests — View PR details, CI checks, and review comments
- Linear Issues — View issue details, status, assignee, priority
Lifecycle
| Status | Description |
|---|---|
initializing | Setup scripts running |
active | Ready and in use |
paused | Temporarily suspended |
errored | Setup or agent failure |
archived | Completed, hidden from sidebar |
deleted | Worktree removed |
Management
- Archive — Hide completed workspaces (worktree preserved)
- Unarchive — Restore archived workspaces
- Delete — Remove workspace and its git worktree
- Rename — Change workspace display name
- Reorder — Drag workspaces in the sidebar