Skip to main content

​
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).