What problem does it solve?
The captain role solves the coordination problem of running cooperative AI work across tmux panes by letting one agent handle implementation while the captain reviews, tests, and integrates changes.
Core Features & Use Cases
- Delegation-first workflow: Offloads implementation to mate using
mate assign and structured task instructions, so the captain focuses on planning and verification.
- Issue-driven execution: Runs an end-to-end GitHub issue workflow via
mate issues, reading synced issue files and working through a chosen batch.
- Steer-and-review loop: Uses
mate wait, reads mate updates, and applies mid-task corrections with mate steer, then finalizes with acceptance when ready.
- Git ownership and PR readiness: Keeps git management with the captain, ensuring reviews, tests, commits, and pushes are owned by the captain rather than the mate.
Quick Start
Ask the captain role to delegate an issue to mate by providing a clear task breakdown after running mate assign --issue 42 --title "Short description" via stdin.