> ## Documentation Index
> Fetch the complete documentation index at: https://captain.blode.md/llms.txt
> Use this file to discover all available pages before exploring further.

# Captain

Captain a fleet of cmux worktrees from one Claude Code session.

Captain a fleet of [cmux](https://cmux.com/) worktrees from one Claude Code session, one worktree per Linear ticket.

Each worktree runs its own agent on a brief covering the whole job: plan, implement, review, open a PR. From your captain session you watch them all with `captain status`, approve their plans, and answer what they're blocked on. The child agents do the work; you steer.

## Requirements

- Node.js >= 22
- `git`, `claude` ([Claude Code](https://claude.com/claude-code)), and [`cmux`](https://cmux.com/) on your PATH
- `LINEAR_API_KEY` (optional, pulls ticket details and screenshots into each brief)

## Install

```bash
npm i -g cmux-captain                 # the CLI
npx skills add mblode/captain -g      # the captain skill
npx skills add mblode/agent-skills -g # the PR skills the brief runs
captain doctor                        # check your setup
```

See [Usage](/usage) for the commands and how a worktree reaches "ready to merge".