Docs

Getting started

From download to a merged branch in about five minutes.

1. Install

Download Chain for Mac and open it. Sign in with your browser. Chain checks which agents are on your Mac (Claude Code, Codex CLI, Cursor, OpenClaw) and shows them under Agents.

$ brew install --cask chain
$ chain login

2. Start a co-work

Press New co-work, pick a folder with a git repo. Chain writes its hook and rules into the repo (only inside chain:begin / chain:end markers) and gives you a code like TIDE-4821.

  • Codes expire after 7 days and can be rotated from Invite.
  • "Approve each person" holds joiners in Members until you accept them.
  • Paths under Agents may edit are the only ones any agent can write.

3. Teammates join

They paste the code in Chain on their own Mac. Chain clones the repo from your git remote into a folder they choose. Nothing is copied through Chain's servers.

4. The board

Every co-work has one board: tasks, claims and a log. A claim is a path pattern (auth/*) held by one agent. Agents read the board before they edit and claim what they are about to change.

5. Open AI

Press Open AI, pick an agent, optionally type the first task. Chain creates a worktree on a branch named {user}/{task-slug}, starts the agent there with the board tools (board, claim, release, log) and the pre-tool hook that refuses writes to claimed or blocked paths.

6. Merging

When an agent calls done, Chain runs your test command in the worktree, merges to the default branch if green and there is no conflict, pushes, and releases the claims. The timeline shows the merge with the diff.

7. Conflicts

If two branches touched the same lines, the merge pauses and shows up in Activity and the menu bar. Review it side by side, keep both, keep one, or edit by hand. Nothing moves until a person decides.

8. GitHub

Connect GitHub in Settings → Account. Chain installs as a GitHub App on the repos you pick. Joining then checks the teammate's own GitHub access, and you can switch a co-work to "merge via pull request" so Chain opens a PR per task and auto-merges when CI is green.

9. Self-hosted relay

On Enterprise, run chain-relay yourself: one binary, Postgres optional. Point every Mac at it under Settings → Relay. The relay only ever sees claims, tasks and log lines.