Starting a Feature from Linear
1
Search for an issue
Press
Cmd+K, type #, and search for the Linear issue you want to work on.2
Create workspace
Select the issue and click Create Workspace. Commander creates an isolated git worktree and
links it to the issue.
3
Setup runs automatically
Your configured setup scripts (e.g.,
pnpm install) run in the new worktree.4
Agent starts working
The agent begins with full context from the Linear issue — title, description, labels, and
priority.
5
PR auto-links
When the agent creates a pull request, it’s automatically linked to the Linear issue.
Reviewing PR Feedback
1
Open the workspace
Click the notification or navigate to the workspace linked to the PR.
2
View comments
PR review comments appear in the right sidebar with file paths and line numbers.
3
Auto-resolve (optional)
If Auto-Resolve PR Comments is enabled, an agent automatically addresses each comment and
pushes changes.
4
Manual resolution
Otherwise, send the agent a message like “Address the PR review comments” and it will work
through them.
Morning Standup with the Manager
1
Open Manager view
Press
Cmd+2 to open the Manager view.2
Ask for a summary
Type “What happened overnight?” or “Give me a status update.” The manager summarizes all
workspace activity.
3
Review suggested actions
The manager suggests next steps as clickable buttons — like “Resume paused agents” or “Start
next priority issue.”
4
Take action
Click suggestions or give the manager instructions like “Start a workspace for the top-priority
bug.”
Running Multiple Agents on One Task
1
Create a workspace
Create a workspace for the feature you’re building.
2
Start the first agent
Send the first agent a focused prompt, e.g., “Implement the database schema and migrations.”
3
Add more agents
Start additional agents in the same workspace with different focuses: “Write the API endpoints”,
“Add unit tests.”
4
Monitor in parallel
Switch between agent tabs to monitor progress. Each agent works in the same worktree but on
different files.
5
Resolve any conflicts
If agents modify the same files, review the changes in the diff viewer and resolve conflicts.
Auto-Fixing CI Failures
1
Enable auto-fix
In repository settings, toggle Auto-Fix CI and set a max retry count.
2
CI fails on a linked PR
When CI checks fail on a workspace’s linked pull request, Commander detects it automatically.
3
Agent analyzes logs
An agent examines the CI failure logs to understand what went wrong.
4
Fix and push
The agent makes the necessary changes and pushes a new commit.
5
Retry limit
If the fix doesn’t work, the agent retries up to your configured limit (default: 3 attempts).