信息卡

一句话定位

一个用于运行 Agent 编队（crew of agents）的 "agent distro"：你只与一位"大副"对话，由它派生、监督并回收一整队并行干活的 Agent，最终交付 PR、本地合并或调查报告。

趋势解读：为什么火

多智能体编程的痛点已从"能不能派活"变成"怎么管":并行任务互相踩工作区、监督自身烧 token、会话断了状态全丢。firstmate 用最朴素的 Shell + Git 方案给出答案——worktree 隔离、事件驱动的零 token 看护、磁盘持久化、重启自动对账，而且它自述"不是模型、不是 harness、不是技能、不是 MCP 服务器也不是 CLI"，只是分层纪律。这种反框架的极简哲学加上航海隐喻的产品叙事（captain → first mate → crewmates），在 Agent 编排工具同质化的当口极具辨识度，故以仅 4149 总星拿下月增约 2300 的爆发。

核心功能拆解

• One liaison：只与大副沟通；其负责任务分派与监督，仅在需要真实决策时上报。
• A visible crew：每个成员在独立 tmux 窗口（或 herdr/zellij tab、cmux workspace、Orca 终端）中工作，可旁观可介入。
• Disposable worktrees：每任务跑在干净的 treehouse git worktree 里，天然规避并行冲突。
• Two task shapes：ship 任务交付授权变更，scout 任务产出独立调查报告。
• Explicit project modes：`no-mistakes` / `direct-PR` / `local-only` 三种交付模式，附 `+yolo` 合并自治标志。
• Optional secondmates：可选持久化二副，独立 FM_HOME 与会话锁，本地或 SSH 主机皆可。
• Event-driven, zero-token supervision：bash watcher 仅在必要时唤醒大副，不空转烧钱。
• Strict project boundary：大副对项目只读，受保护操作须硬规则授权。
• Restart-proof：状态全存磁盘与会话后端，杀掉后重开自动恢复。

架构与技术栈浅析

无服务进程的纯文件编排：克隆即发行版，核心是 AGENTS.md（给大副的宪法）、内置技能与辅助脚本。拓扑为 captain（人）→ firstmate → fm-task1…fm-taskN 多个成员 → 各自 worktree 或 secondmate home，ship 流程收束为 PR/本地合并后拆除，scout 流程交报告后拆除。监督靠 bash watcher 监听 tmux/会话事件做零 token 唤醒，状态机完全落盘实现重启对账。

安装与环境要求

macOS 或 Linux；需 Git、GitHub CLI（先 `gh auth login`）及至少一个经验证的 primary harness："Claude Code, Grok, Pi, `pi-signed`, Codex, OpenCode, or Cursor Agent CLI"；tmux 为参考默认终端复用器，缺失工具会在批准后代为安装。安装三步：

gh auth login
git clone https://github.com/kunchenguid/firstmate
cd firstmate

快速上手示例

在仓库目录启动 harness：

claude        # Claude Code
grok --trust  # Grok（--trust 让项目钩子生效）
pi            # Pi

然后直接下指令：`> ahoy! look at my github project xyz, then fix the flaky login test and add dark mode`——大副检查工具链、把项目克隆进 projects/ 并派出两个隔离 worker，完成后回报 "PR ready for review, captain" 附 PR 链接，回一句 "alright merge it" 即合并。

进阶使用要点

• 上线前先用 scout 模式让编队做只读调查，验证边界规则后再放开 ship。
• `/afk` 离开模式可托管通知、生成批量摘要并在交付卡住时告警。
• `/bearings` 从本地状态生成四段式进度摘要，适合晨会汇报。
• 重大项目引入 secondmates 获得持久工作目录与跨机执行能力。
• 修改 AGENTS.md 即可定制项目级硬规则与授权清单。

典型应用场景

• 一人多仓维护者同时推进 fixes、investigations、plans、audits。
• 大型重构拆成多个 ship 任务并行落地、统一评审。
• 睡前派活 `/afk` 挂机，早上一键收 PR。
• 安全审计等只读侦察交给 scout 成员出报告。

同类生态位对比

Claude Squad/Claude Flow 提供完整编排平台但较重；Graphite/Dagger 类 CI 化方案偏离本地开发节奏；原生 `claude --background` 只管单任务。firstmate 以零依赖、可视化和省钱 supervision 占据"轻量舰队指挥"生态位。

资源导航

GitHub：https://github.com/kunchenguid/firstmate ；许可证见仓库 LICENSE（MIT）；上手必读 AGENTS.md 与仓库 README 的 Features 全表。