Quickstart

Karma is a native macOS workspace that runs several coding agents at once — Claude Code, Pi, Codex, OpenCode, Cursor, Antigravity — each on its own branch, in its own working directory, under your review. This page gets you oriented in about five minutes.

The mental model: one worktree per task

Karma is built on git worktrees — a standard git feature that lets one repository check out several branches into separate directories at the same time. Your main checkout stays untouched; every agent task gets a fresh linked worktree on a fresh branch.

Each agent works on an isolated branch in its own directory. Nothing reaches main until you review and merge it.

Because every agent has a private working directory, three agents can edit the same file on three branches without a single conflict while they work. It is the same isolation you get from cloning the repo three times — without three clones:

# what Karma manages for you, per task
git worktree list
/Users/you/project              a1b2c3d  [main]
…/karma/feat-login              e4f5a6b  [feat/login]      # @pi-coder
…/karma/fix-reconnect           c7d8e9f  [fix/reconnect]   # @claude-reviewer
…/karma/chore-tests             1a2b3c4  [chore/tests]     # @codex-tester

You never manage worktrees by hand. Karma creates one when an agent starts a task, keeps its diff visible live, and removes it after you merge or discard. If you already know git worktrees, Karma is that — plus agents, supervision, and review.

Install

Download and open

Download the DMG (universal, signed and notarized), drag Karma to Applications, and open it.

Point it at code

First run offers three ways in: open a folder that is already a git repository, clone one, or start a scratch project to experiment safely.

Bring your agents

Karma orchestrates the agent CLIs you already use — install and sign in to any of claude, pi, codex, opencode, cursor, or antigravity. Karma detects what is on your PATH and shows exactly what is ready.

No account, no sign-in: Karma has nothing to log into. Projects, sessions, and review data stay on your machine — see the privacy policy.

Your first parallel session

Open your project

Karma shows your repo as a workspace with your default branch checked out — the same shape as any IDE.

Add an agent

Pick a harness (say Claude Code) and a role — implementer, reviewer, tester, architect, debugger, or docs. Roles set the agent's autonomy and scope. Give it a task; Karma spins up its worktree and live terminal.

Add more agents

Each new agent gets its own branch and worktree. Watch them all work at once — every terminal is live, and the sidebar tracks each branch's diff in real time.

Let them talk — under supervision

Agents hand work to each other through the Relay: typed, supervised messages (ask, report, handoff, review). Risky traffic is held for your approval; routine traffic flows. See the developer docs for the full protocol.

Review and merge — locally

When an agent finishes, read the diff in Karma's native review, leave line comments the agent must resolve, then merge into your branch — or discard the worktree without a trace. GitHub and GitLab stay as mirrors; the decision happens on your machine.

Where to go next

Developer docs — the karma-build CLI your agents use to message, review, spawn, and inspect each other.
Overview — the product tour, supported harnesses, and download.
Questions? dev@karma.build or the community links in the footer.