Skip to main content

​
Installation

Download the latest Commander DMG from the releases page or the Commander website.
  1. Open the DMG and drag Commander to Applications
  2. Launch Commander from Applications or Spotlight

​
Connect Your Claude Account

Commander needs a Claude account to power its AI agents.
1

Open Settings

Press Cmd+Shift+P or click the gear icon in the sidebar.
2

Go to Integrations

Select the Integrations tab.
3

Add Claude Account

Choose one of three methods:
  • Detect CLI — If you have Claude Code CLI installed and logged in, Commander detects it automatically
  • OAuth Login — Sign in with your Claude subscription via browser
  • API Key — Enter an Anthropic API key manually (stored in macOS Keychain)

​
Add a Repository

1

Click Add Repository

In the sidebar, click the + button next to Repositories.
2

Select a Folder

Choose a local git repository from your filesystem.
3

Configure (Optional)

Set up setup scripts (e.g., pnpm install), default model, and integrations in the repository settings.

​
Create Your First Workspace

1

Create Workspace

Press Cmd+N or click New Workspace in the sidebar.
2

Name and Branch

Give it a name and optionally specify a branch. Commander creates an isolated git worktree automatically.
3

Write a Prompt

Type your initial prompt — what you want the agent to build, fix, or review.
4

Watch It Work

The agent starts immediately. You can see every message, tool call, and file edit in real time.

​
Next Steps

  • Run multiple agents in the same workspace for parallel tasks
  • Connect GitHub and Linear to create workspaces from PRs and issues
  • Enable the Orchestrator to coordinate agents automatically
  • Explore Core Concepts to understand the full architecture