Firstmate 编码代理舰队
用一个对话入口调度并监督并行编码代理,交付可审阅的变更或调查报告。
- Star 数
- ★ 8.1k
- 最近更新
- 今天
- License
- MIT
- 主语言
- Shell
- FA 评分
- 45/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 兼容但需适配Codex · Claude Code
- 上手难度
- 高 · 需要较重的基础设施
- 开始前需要
- 典型场景
- 需要同时修复多个缺陷的开发者,可将独立任务派给各自 worktree 中的代理。
- 不适合
- 只想运行单个编码会话、无需并行任务的用户
- 不使用受支持终端编码代理的团队
- 源码审查
- 45/100 · 缺口较多
这个 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 接收公开提及并跟进真实里程碑或最终结果。
- 需要同时修复多个缺陷的开发者,可将独立任务派给各自 worktree 中的代理。
- 维护大型代码库的团队,可把调查、计划和审计作为独立 scout 任务执行并取得报告。
- 希望在合并前逐项审阅成果的维护者,可配置 no-mistakes 或 direct-PR 项目模式。
- 偏好本地交付流程的开发者,可用 local-only 模式并由船长授权本地合并。
- 需要扩大代理队伍的操作者,可在本机或 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?
查看各维度的扣分理由
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 验证,且文档未系统标注外部来源与引用,扣分。
自洽性:README、configuration.md、verification 文档在 FM_HOME、backend、supervision 等概念上相互一致,术语使用稳定,给 2。依赖可用性:依赖大量外部工具(tmux、gh、treehouse、herdr、quota-axi、Pi 包、tasks-axi),部分在 CI 中固定版本,但 tasks-axi 与 Pi 包未固定,且 quota-axi 有版本下限而无锁定,扣分。失败信息:文档描述了若干失败处理(模型不可用则拒绝构建并回传、写入失败不报告已保存、路径不可解析时报出变量名),但缺少面向用户的统一错误码或诊断目录,扣分。
受众与场景: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 未提及,扣分。
信息架构:README 有清晰的功能、快速开始、工作原理、技能表、文档索引,configuration.md 有查找表,给 2。安装说明:给出 gh auth login、clone、各 harness 启动命令及信任提示,给 2。命名稳定性:技能名与配置文件名较多且部分标注实验性,未见版本化命名策略,扣分。示例与 FAQ:有对话示例与 Bearings 调用示例,但无独立 FAQ,扣分。已知限制:文档多处标注实验性后端、codex-app 阻塞、Cursor headless 限制,给 2。许可证:MIT 全文存在,给 2。版本与变更日志:未见 CHANGELOG 或版本号方案,给 0。维护责任:有 CONTRIBUTING.md 引用与作者署名,但无治理、支持渠道或维护者承诺说明,扣分。
输出可用性:交付 PR、本地合并、调查报告,并有 /bearings 摘要,输出形态明确,给 2。边际价值:解决多代理并行编排与会话管理的真实痛点,相对手工多标签有明显增益,给 2。成本效益:依赖大量外部工具与 harness 订阅,配置复杂,且 supervision 有零 token 设计但整体学习与运维成本高,扣分。
主张可追溯: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 试运行。
- 未提供已合并变更或已发布公开回复的回滚路径说明。
常见问题
Firstmate 是模型、CLI 或 MCP 服务吗?
必须使用 Claude Code 吗?
项目变更会怎样交付?
运行需要哪些账号或服务?
gh auth login 认证,并要求所选代理运行时及其会话后端可用。费用未在 README 中说明。