Skip to content
Captain

AI agents: fetch the documentation index at llms.txt. Markdown versions are available by appending .md to any page URL, including this page's markdown.

Captain

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

Captain a fleet of cmux 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), and cmux on your PATH
  • LINEAR_API_KEY (optional, pulls ticket details and screenshots into each brief)

Install

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 for the commands and how a worktree reaches "ready to merge".