Skip to content
Control Center

Quick start

Prerequisites

Section titled “Prerequisites”
  • macOS 13+ (Apple Silicon or Intel) for the prebuilt app. Windows and Linux builds are in progress; you can build from source on all three.
  • Git installed and configured
  • At least one AI agent CLI installed (e.g. Claude Code, Codex CLI, or Pi)
  • A GitHub personal access token with repo and PR permissions

This quick start uses the desktop app in its default local mode, where it spawns its own server. To connect to a server running elsewhere, or to use the web client, see Connect to a remote server.

Step 1: Install and launch Control Center

Section titled “Step 1: Install and launch Control Center”

Download the latest macOS release from GitHub Releases, or install it with Homebrew (brew tap control-center/tap && brew install --cask control-center). Windows and Linux builds are in progress; build from source in the meantime.

On first launch, Control Center asks how it should run. Accept the default — Run locally — and it spawns a headless cc_server that owns your data and talks to it over loopback. You do not see the server; the onboarding screen then opens.

Step 2: Connect GitHub

Section titled “Step 2: Connect GitHub”

Provide your GitHub personal access token. Control Center validates it and stores it securely in your system keychain (macOS Keychain, Windows Credential Store, or Linux libsecret).

If you have the gh CLI installed and authenticated, Control Center detects it automatically.

Step 3: Create a workspace

Section titled “Step 3: Create a workspace”

A workspace is your top-level container: it groups agents, repos, channels, and memory. Give it a name and optionally a logo.

The first workspace also seeds a CEO agent that can hire and coordinate other agents.

Step 4: Add a repository

Section titled “Step 4: Add a repository”

Add a Git repository to your workspace. Control Center inspects the repo and detects its GitHub remote. The repo becomes available for worktree isolation: each agent channel gets its own copy-on-write branch.

Step 5: Dispatch an agent

Section titled “Step 5: Dispatch an agent”

Open a channel with an agent (or mention @agent in any channel). Type your instructions. The agent:

  1. Gets its own isolated worktree
  2. Receives a prompt assembled from its role, persona, skills, and channel context
  3. Executes in a sandbox with capability-gated access to your repos and APIs
  4. Streams its thinking and output back to the channel in real time

Step 6: Review the PR

Section titled “Step 6: Review the PR”

When the agent finishes, it opens a pull request. Open the PR in Control Center’s diff viewer, review the changes, and merge — all without leaving the app.

Next steps

Section titled “Next steps”