kunchenguid/firstmate

解决的问题

Firstmate 解决了开发者必须在不同终端会话和仓库之间手动管理多个并行编码任务（如修复 bug、研究、审计）的「标签切换」问题。用户不再需要逐一照看多个独立的代理，而是与一个单一的「大副」代理交互，该代理负责管理一组自主工作的代理团队，处理任务分派、监督和结果整合。

工作原理

Firstmate 作为一个「代理发行版」——一组指令、工具和策略——将通用编码代理（如 Claude Code、Grok 或 Pi）转变为监督者。

1. 联络模型：用户与大副对话，大副随后在隔离的会话后端（如 tmux、Zellij 或 Orca）中启动船员代理。
2. 隔离：每个船员在独立的干净 git 工作树中运行（通过 treehouse 实现），防止并行任务发生冲突。
3. 监督：基于 bash 的零令牌监控器会持续监视整个舰队，仅在需要人工干预或决策时唤醒大副。
4. 交付：任务分为「船」（产生 PR 或本地合并）或「侦察」（产生调查报告）。
5. 可扩展性：用户可选择加入「二副」（本地或远程 SSH 主机上的持久代理）和「中继」系统，以处理来自 X 和 Discord 的请求。

适用人群

使用 AI 编码代理并希望在不手动管理每个会话上下文和状态的情况下，通过并行运行多个自主任务来提升生产力的开发者。

亮点

• 单一接触点：与一个监督代理交互，即可管理整个代理舰队。
• 可丢弃的工作树：为每个任务提供独立的隔离 git 环境，防止代码冲突。
• 多后端支持：兼容多种终端多路复用器，包括 tmux、Herdr、Zellij、cmux 和 Orca。
• 与哈恩斯无关：支持多种主要代理哈恩斯，包括 Claude Code、Grok、Pi 和 Cursor Agent CLI。
• 重启容错状态：所有状态均持久化存储在磁盘上，即使崩溃或重启后也能恢复和续接会话。