arjmad/firstmate

大副

找一个特工谈谈。带船员的船。

这是什么

你可以轻松运行一个编码代理。 但一旦你想同时完成三个项目任务——修复、调查、计划、审计——你就成了标签整理者：看管会话、在仓库间复制粘贴上下文、忘记哪个终端测试失败。

大副把模型翻了个面。 你只需与一个代理——大副——对话，它会帮你管理船员：在可见的会话后端生成自主代理，给每个代理一个干净的git工作树，监督他们完成，并交付完成的PR、批准的本地合并或独立的调查报告。 对于更大的舰队，你可以选择持久的二副：即仍是普通直属下属，但从该机器或其他SSH可达主机上的独立第一副官家中运行的二副。

Firstmate 不是模型，不是 harness，不是技能，不是 MCP 服务器，也不是 CLI。 Firstmate 是一个用于运营特工团队的代理发行版。 代理发行版是一个可移植的目录，包含指令、技能、工具、策略和状态约定，将通用代理转变为专用代理。

firstmate

<a href=“https://img.shields.io/badge/platform-macOS | Linux-blue?style=flat-square” > <a href=“https://x.com/kunchenguid” > <a href=“https://discord.gg/Wsy2NpnZDu” >

Talk to one agent. Ship with a crew.

What it is

You can run one coding agent easily. But the moment you want three project tasks done in parallel - fixes, investigations, plans, audits - you become a tab-juggler: babysitting sessions, copy-pasting context between repos, forgetting which terminal had the failing test.

firstmate flips the model. You talk to a single agent - the first mate - and it runs the crew for you: spawning autonomous agents in a visible session backend, giving each a clean git worktree, supervising them to completion, and handing you finished PRs, approved local merges, or standalone investigation reports. For larger fleets, you can opt in to persistent secondmates: second mates that are still ordinary direct reports, but run from their own isolated firstmate homes on this machine or another SSH-reachable host.

firstmate is not a model, not a harness, not a skill, not an MCP server, and not a CLI. firstmate is an agent distro for running a crew of agents. An agent distro is a portable directory of instructions, skills, tooling, policies, and state conventions that turns a general-purpose agent into a specialized one. There is no app to install: the cloned repo is the distro - AGENTS.md, bundled firstmate skills, and helper scripts that any terminal coding agent can follow. Launching a supported harness inside it for your primary session instantiates your first mate - and makes you the captain.

Features

• One liaison - you talk only to the first mate; it dispatches, supervises, escalates only real decisions, and reports plain outcomes.
• A visible crew - every crewmate works in its own tmux window or Herdr tab, or in an experimental Zellij tab, experimental cmux workspace, or experimental Orca terminal you can watch or type into; the first mate reconciles.
• Disposable worktrees - each task runs in a clean treehouse git worktree, or an Orca-managed worktree when backend=orca, so parallel work on one repo never collides.
• Two task shapes - ship tasks deliver authorized changes; scout tasks leave standalone investigation reports when the intake contract warrants separate research.