> ## Documentation Index
> Fetch the complete documentation index at: https://commander-docs.cyshel.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Get Commander up and running in minutes.

## Installation

Download the latest Commander DMG from the [releases page](https://releases.cyshel.com) or the [Commander website](https://commander.cyshel.com).

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.

<Steps>
  <Step title="Sign in with Google">
    Click **Sign in with Google** on the login screen. This creates your Commander account.
  </Step>

  <Step title="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
  </Step>
</Steps>

## Connect Your Claude Account

Commander needs a Claude account to power its AI agents.

<Steps>
  <Step title="Open Settings">
    Press `Cmd+Shift+P` or click the gear icon in the sidebar.
  </Step>

  <Step title="Go to Integrations">
    Select the **Integrations** tab.
  </Step>

  <Step title="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.
  </Step>
</Steps>

## Add a Repository

<Steps>
  <Step title="Click Add Repository">
    In the sidebar, click the **+** button next to Repositories.
  </Step>

  <Step title="Select a Folder">Choose a local git repository from your filesystem.</Step>

  <Step title="Configure (Optional)">
    Set up setup scripts (e.g., `pnpm install`), default model, and integrations in the repository
    settings.
  </Step>
</Steps>

## Create Your First Workspace

<Steps>
  <Step title="Create Workspace">Press `Cmd+N` or click **New Workspace** in the sidebar.</Step>

  <Step title="Name and Branch">
    Give it a name and optionally specify a branch. Commander creates an isolated git worktree
    automatically.
  </Step>

  <Step title="Write a Prompt">
    Type your initial prompt — what you want the agent to build, fix, or review.
  </Step>

  <Step title="Watch It Work">
    The agent starts immediately. You can see every message, tool call, and file edit in real time.
  </Step>
</Steps>

## 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](/concepts/primitives) to understand the full architecture