Skip to content
Control Center

Quick start

Prerequisites

Section titled “Prerequisites”
  • macOS 12+ (Apple Silicon or Intel), Windows 10+, or Linux with a graphical environment
  • 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

Step 1: Install Control Center

Section titled “Step 1: Install Control Center”

Download the latest release for your platform from GitHub Releases.

On first launch, Control Center opens the onboarding screen.

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 conversation 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 conversation 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”