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

​
Sign In

Commander requires a Google account to get started.
1

Sign in with Google

Click Sign in with Google on the login screen. This creates your Commander account.
2

Complete Onboarding

The onboarding flow guides you through three steps: 1. Connect a Repository — Add your first git repository 2. Managers — Learn about the manager system that coordinates your agents 3. Awareness — Configure the persistent memory layer for managers

​
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. Shows your subscription type and organization.
  • OAuth Login — Sign in with your Claude subscription via browser
  • API Key — Enter an Anthropic API key manually (stored in macOS Keychain)
You can add multiple accounts and assign them to specific repositories.

​
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 Manager to coordinate agents automatically
  • Use screenshots to share visual context with agents
  • Set up environments with devcontainers or GitHub Codespaces for reproducible dev setups
  • Explore Core Concepts to understand the full architecture