kunchenguid/firstmate: Talk to one agent. Ship with a crew.

firstmate is an agent distro, not a model, harness, CLI, MCP server, or skill, and the cloned repo itself is the distro users run
You talk to a single “first mate” agent, which spawns and supervises multiple autonomous crewmates to finish tasks in parallel
Each crewmate runs in its own visible session backend and gets a clean git worktree to avoid collisions
Two task types are supported: ship tasks produce code changes, while scout tasks produce investigation, planning, reproduction, or audit reports
Projects can be run in explicit modes such as no-mistakes, direct-PR, or local-only, with an optional +yolo autonomy flag
Optional persistent secondmates can run from isolated firstmate homes with their own state, projects, and session lock
Supervision is event-driven and zero-token: a bash watcher sleeps until something needs attention, then wakes the first mate
An optional X mode lets firstmate respond to public @ mentions and post limited public-safe follow-ups for real milestones
The first mate is read-only over projects except for guarded clone refreshes, safe branch pruning, and approved local-only fast-forward merges
The system is restart-proof because state lives on disk and in the active session backend, so killing a session can be reconciled on the next launch

Your notes

Save this item to your library to add private notes.