Firstmate 编码代理舰队

用一个对话入口调度并监督并行编码代理,交付可审阅的变更或调查报告。

Star 数
★ 8.1k
最近更新
今天
License
MIT
主语言
Shell

30 秒速览

运行形态
命令行工具Agent 插件 / 技能
可在哪里用
兼容但需适配Codex · Claude Code
上手难度
高 · 需要较重的基础设施
开始前需要
GitGitHub CLIClaude Code、Grok、Pi、pi-signed、Oh My Pi (omp)、Codex、OpenCode 或 Cursor Agent CLItmux 或其他选定的会话后端treehouse,除非 backend=orcaShell / 命令行网络访问本地文件系统
典型场景
需要同时修复多个缺陷的开发者,可将独立任务派给各自 worktree 中的代理。
不适合
  • 只想运行单个编码会话、无需并行任务的用户
  • 不使用受支持终端编码代理的团队

这个 Agent 能做什么,适合哪些场景?

Firstmate 是一个面向终端编码代理的代理发行包,仓库目录本身包含 AGENTS.md、内置技能和辅助脚本。用户在仓库内启动 Claude Code、Grok、Pi、Oh My Pi、Codex、OpenCode 或 Cursor Agent CLI 等受支持主代理后,主代理会担任联络者并调度独立代理。每项任务在可见的 tmux、Herdr、Zellij、cmux 或 Orca 会话中运行,并使用独立的 treehouse Git worktree,或在 Orca 后端下使用 Orca 管理的 worktree。交付包括拉取请求、经授权的本地合并或独立调查报告;大型部署还可选择本机或 SSH 可达主机上的持久 secondmate。它需要 Git、已认证的 GitHub CLI、受支持的代理运行时及所选会话后端,主要适用于需要把多个项目任务并行处理的开发者。

用户先在项目目录提出修复、调查、计划或审计请求;firstmate 检查工具链,并在安装缺失工具前征求同意。它将工作分派到各自会话和隔离 Git worktree 的 crewmate,监控任务直到完成,再按项目模式提供 PR、经授权的本地合并或独立调查报告。默认 tmux 会话可见,其他文档支持的后端包括 Herdr、Zellij、cmux 和 Orca。事件驱动的 bash watcher 在需要处理时唤醒主代理;可选 Relay 可通过 X 和 Discord 接收公开提及并跟进真实里程碑或最终结果。

  1. 需要同时修复多个缺陷的开发者,可将独立任务派给各自 worktree 中的代理。
  2. 维护大型代码库的团队,可把调查、计划和审计作为独立 scout 任务执行并取得报告。
  3. 希望在合并前逐项审阅成果的维护者,可配置 no-mistakes 或 direct-PR 项目模式。
  4. 偏好本地交付流程的开发者,可用 local-only 模式并由船长授权本地合并。
  5. 需要扩大代理队伍的操作者,可在本机或 SSH 可达主机配置持久 secondmate。

如何安装或部署这个 Agent?

需要 Git、GitHub CLI,并通过 gh auth login 完成认证;还需要选择一个受支持的终端代理运行时和会话后端。README 将 tmux 列为参考默认后端,具体后端依赖需按所选运行时配置。

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

然后从仓库目录启动一个受支持的主代理,例如 Claude Code:

claude

如何使用这个 Agent?

启动主代理后,在对话中提出具体任务;主代理会检查工具链、征求安装缺失工具的同意,并派发隔离任务。例如:

ahoy! look at my github project xyz, then fix the flaky login test and add dark mode

完成后,firstmate 会报告 PR、本地合并结果或调查报告。README 示例中的后续操作是:

alright merge it

这个 Agent 有哪些优点和局限?

优点
  • 单一联络者负责派发、监督和结果汇报,减少用户在多个终端会话之间切换。
  • 每项任务使用独立 Git worktree,支持同一仓库中的并行工作而减少冲突。
  • 提供 ship 和 scout 两种任务形态,可交付代码变更,也可单独交付调查报告。
  • 文档列出多个受支持主代理和会话后端,并支持可选的持久 secondmate。
局限
  • 部署需要 Git、已认证的 GitHub CLI、受支持的编码代理以及会话后端,首次配置较繁琐。
  • 各代理的监督行为有差异;例如 Codex 使用有界前台检查点,OpenCode 使用 TUI 插件。
  • Zellij、Orca 和 cmux 后端在 README 中标为实验性。
  • Relay、secondmate 等能力需要额外配置;README 没有说明软件或模型服务的费用。

这个 Agent 与同类方案有什么区别?

README 将它与手动管理多个编码代理会话的方式作对比:firstmate 提供单一对话入口,并负责派发和监督。README 未提供与其他具体产品的功能比较。

与相关度最高的同类 agent 并排比较关键指标。

Agent 源码审查 形态 / 费用 Star 最近更新 主语言 完整支持的平台
Firstmate 编码代理舰队 当前 45 · 缺口较多 命令行工具 ★ 8.1k 今天 Shell Codex · Claude Code
ClawTeam for OpenClaw 64 · 存在缺口 命令行工具免费 + 模型费 ★ 1.5k 3 个月前 Python Codex · Claude Code
dmux 69 · 存在缺口 命令行工具免费 + 模型费 ★ 1.8k 2 个月前 HTML Codex · Claude Code · OpenAI API
Cezar — AI 编码代理编排器 63 · 存在缺口 命令行工具免费 ★ 743 今天 TypeScript Codex · Claude Code

FollowAgents 如何评估这个 Agent?

FollowAgents 源码审查 · FARS-2.1
缺口较多
45/ 100 五分制 2.3 / 5
信任安全 12/29
可靠稳定 6/14
适用触发 9/18
规范维护 8/18
有效结果 7/13
证据核验 3/8
查看各维度的扣分理由
信任安全12 / 29 · 2.1/5

README 与 docs/configuration.md 明确描述了最小权限设计:firstmate 对项目只读,仅通过 AGENTS.md 硬规则 1 的受控例外与船长批准操作改动项目;self-repo 边界默认禁止向上游推送,需 config/firstmate-role 或逐任务同意。用户确认方面有安装前征询、合并需船长批准、+yolo 为显式可选。但数据流透明度仅部分:Relay 需 .env 配对令牌、X/Discord 公开回复,文档提到 dry-run 预览,但未给出完整的数据流向与保留说明,扣分。敏感数据处理:文档提到凭据不被复制/转换、模型 pin 文件 0600 原子写入,但缺少对令牌、日志、transcript 中敏感信息的系统性处理说明,扣分。依赖安全:CI 固定 ShellCheck/actionlint/Herdr 0.7.4 等版本,但 tasks-axi、Pi 包在 CI 中未固定版本,且未见依赖漏洞扫描,扣分。外部效应:会创建 PR、合并、公开发布回复,虽有模式与同意门控,但默认能力面较大且缺少统一的外部效应清单,扣分。回滚:有 /updatefirstmate 的受保护更新与重启、worktree 隔离、状态落盘,但缺少对已合并变更或已发布公开回复的回滚路径说明,扣分。来源归属:LICENSE 署名 Kun Chen,README 链接作者 X 与 Discord,但发布者身份未经 FollowAgents 验证,且文档未系统标注外部来源与引用,扣分。

可靠稳定6 / 14 · 2.1/5

自洽性:README、configuration.md、verification 文档在 FM_HOME、backend、supervision 等概念上相互一致,术语使用稳定,给 2。依赖可用性:依赖大量外部工具(tmux、gh、treehouse、herdr、quota-axi、Pi 包、tasks-axi),部分在 CI 中固定版本,但 tasks-axi 与 Pi 包未固定,且 quota-axi 有版本下限而无锁定,扣分。失败信息:文档描述了若干失败处理(模型不可用则拒绝构建并回传、写入失败不报告已保存、路径不可解析时报出变量名),但缺少面向用户的统一错误码或诊断目录,扣分。

适用触发9 / 18 · 2.5/5

受众与场景:README 清晰面向使用多个编码代理的开发者,给出并行修复、调查、审计等场景,给 2。能力边界:明确声明不是模型、不是 harness、不是 skill、不是 MCP server、不是 CLI,并列出 codex-app 未支持、Zellij/Orca/cmux 为实验性,给 2。触发精度:技能触发依赖 AGENTS.md 与各 harness 的 hook,文档承认 Cursor headless 无 turn-end hook、Grok 需 --trust 等差异,触发条件复杂且部分依赖 harness 行为,扣分。环境适配:仅支持 macOS/Linux,需 tmux 等,Windows 未提及,扣分。

规范维护8 / 18 · 2.2/5

信息架构:README 有清晰的功能、快速开始、工作原理、技能表、文档索引,configuration.md 有查找表,给 2。安装说明:给出 gh auth login、clone、各 harness 启动命令及信任提示,给 2。命名稳定性:技能名与配置文件名较多且部分标注实验性,未见版本化命名策略,扣分。示例与 FAQ:有对话示例与 Bearings 调用示例,但无独立 FAQ,扣分。已知限制:文档多处标注实验性后端、codex-app 阻塞、Cursor headless 限制,给 2。许可证:MIT 全文存在,给 2。版本与变更日志:未见 CHANGELOG 或版本号方案,给 0。维护责任:有 CONTRIBUTING.md 引用与作者署名,但无治理、支持渠道或维护者承诺说明,扣分。

有效结果7 / 13 · 2.7/5

输出可用性:交付 PR、本地合并、调查报告,并有 /bearings 摘要,输出形态明确,给 2。边际价值:解决多代理并行编排与会话管理的真实痛点,相对手工多标签有明显增益,给 2。成本效益:依赖大量外部工具与 harness 订阅,配置复杂,且 supervision 有零 token 设计但整体学习与运维成本高,扣分。

证据核验3 / 8 · 1.9/5

主张可追溯:verification 文档给出验证日期、版本与命令输出,可追溯性较好,但 README 中大量功能主张未逐条链接到验证记录,扣分。跨源印证:README、configuration.md、verification 文档在部分事实(如 quota-axi 版本、Herdr 固定版本)上互相印证,但多数主张仅单一来源,扣分。事实与推断分离:verification 文档明确区分观测与推断(如缺失字段视为不确定),但 README 营销性表述与事实混排,扣分。

风险与缓解建议
  • 发布者身份未经 FollowAgents 验证,仓库来源应视为未知,部署前应独立核实。
  • Relay 功能会以配对令牌代表用户公开发布 X/Discord 回复,需确认令牌保管、公开内容边界与撤销方式。
  • 依赖大量外部工具与 harness(tmux、gh、treehouse、herdr、quota-axi、Pi 包、tasks-axi),部分未固定版本,环境漂移风险较高。
  • 缺少 CHANGELOG 与版本方案,升级与兼容性判断只能依赖提交历史。
  • 默认能力包含创建 PR、合并与公开发布,建议先以 no-mistakes 或 local-only 模式并关闭 +yolo 试运行。
  • 未提供已合并变更或已发布公开回复的回滚路径说明。
证据充分度:低 评估于 2026年10月20日 审查版本 9d76aa8e0a31
查看完整评分方法 →

常见问题

Firstmate 是模型、CLI 或 MCP 服务吗?
不是。README 将它描述为代理发行包;克隆仓库后,在其中启动受支持的终端编码代理即可实例化主代理。
必须使用 Claude Code 吗?
不必。README 还列出 Grok、Pi、pi-signed、Oh My Pi、Codex、OpenCode 和 Cursor Agent CLI;不同运行时的监督方式和限制各有差异。
项目变更会怎样交付?
依据项目模式和任务类型,结果可以是拉取请求、经授权的本地合并或独立调查报告。
运行需要哪些账号或服务?
快速开始要求 GitHub CLI 已通过 gh auth login 认证,并要求所选代理运行时及其会话后端可用。费用未在 README 中说明。
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。

相关 Agents