firstmate

产品简介

firstmate 是一个开源的多 Agent 调度分发框架，本质是一套精心组织的粘合代码（bash 脚本 + AGENTS.md 指令），将 Claude Code、Grok、Pi、Codex、OpenCode 等终端编程 Agent 变成舰队主管。用户只需与「第一助手（first mate）」对话，它会自动生成并管理多个「船员（crewmate）」Agent，在独立的 tmux 窗口/herdr 标签/cmux 工作区/Orca 终端中并行处理任务。

核心功能

单一联络点 用户只与 first mate 对话，它负责分发任务、监督执行，仅在需要决策时才升级给用户。大幅降低认知负担，让用户专注于高价值决策，而非任务调度。

可见舰队 每个船员在独立的 tmux 窗口中工作，用户可随时观看或输入干预，任务执行过程完全透明可追溯。

一次性 git worktree 并行任务使用干净的 git worktree（如 treehouse 或 Orca），同一仓库的并行任务永远不会冲突，保证并行效率的同时维护代码完整性。

两种任务形态 Ship 任务交付变更；Scout 任务调查、规划、重现或审计并留下报告。不同任务类型适配不同工作场景。

显式项目模式 每个项目通过 no-mistakes、direct-PR 或 local-only 模式发货，支持 +yolo 自治标志，满足不同风险偏好和团队规范。

可选第二助手（Secondmates） 持久化领域监督者，从各自独立的首选项主页运行，由受保护本地快速转发保持同步，多维度质量保障。

事件驱动零 Token 监督 bash watcher 在舰队上休眠，仅在需要时才唤醒，节省 Token 消耗，降低使用成本。

构建保障 除清洁的默认分支刷新、安全的分支修剪和批准的本定快速转发合并外，第一助手对项目保持只读，从架构上防止未经授权的代码修改。

可重启恢复 所有状态保存在磁盘和 tmux 中，终止会话后下次可完全恢复，无需从头开始，保证开发连续性。

X 模式（可选） 配置一个 token 让舰队响应公开的 @myfirstmate 提及并发布完成通知，实现与社交平台的无缝集成。

适用场景

• 开发者需要同时处理多个并行任务（修复、审计、规划）而不想开多个终端标签
• 团队希望用 AI Agent 自动化并行代码审查、修复和调研
• 需要在 CI 中协调多个 Agent 协作完成复杂任务

快速上手

先决条件：已验证的 Agent 工具链（claude/codex/opencode/pi）、git + GitHub 认证、tmux gh auth login && git clone https://github.com/kunchenguid/firstmate && cd firstmate && claude 启动 Agent 工具链后，AGENTS.md 接管，直接对话：「ahoy!」即可启动舰队