Repolode
kunchenguid

kunchenguid/firstmate

一套用于调度多个编码智能体的 agent distro:你只与一个“大副”对话,它把并行任务分派到隔离的 git worktree 和可见会话中。

Star
8,661
Fork
2,716
未关闭 Issue
2,608
最近提交
昨天

这是什么?

firstmate 是一套可移植的指令、技能与辅助脚本目录,能把通用的终端编码智能体变成多智能体团队的协调者。它无需安装应用:克隆仓库后,在其中启动 Claude Code、Grok、Pi、Codex、OpenCode 等受支持的 harness,该会话即成为“大副”。你在对话中描述需求,大副会派出自主运行的“船员”,每个船员拥有独立的可见会话和干净的 git worktree,并持续监督直到产出 PR、批准的本地合并或调查报告。

它面向的问题是:同时跑多个编码智能体时,人需要不停切换终端、在仓库间复制上下文,还容易忘记哪个任务失败了。监督基于事件驱动,由一个 watcher 在船员需要决策时才唤醒大副。每个项目可设置通过 PR、直接提交 PR 或仅本地合并的方式交付;也可选择让持久化的“副大副”在本机或可通过 SSH 访问的主机上,于独立目录中运行。

项目支持 macOS 与 Linux,会话后端以 tmux 为默认参考实现,并提供 herdr、Zellij 等其他后端,其中部分标为实验性。

核心功能

  • 01只与一个大副对话,由它派发并监督多个并行船员。
  • 02每个任务使用独立的临时 git worktree,同一仓库的并行工作互不冲突。
  • 03船员运行在可见的 tmux 窗口或其他受支持的会话后端中,可随时查看或介入。
  • 04每个项目可设置交付方式:通过 PR、直接提交 PR 或仅本地合并。
  • 05可选的持久化副大副能在本机或 SSH 可达的主机上,于隔离目录中运行。
  • 06事件驱动的 watcher 仅在需要决策时唤醒大副。

适用场景

  • 同时在多个仓库中推进多个修复或功能任务。
  • 把代码库调研或审计交给智能体,并获得书面报告。
  • 在单一对话中调度一组编码智能体,无需来回切换终端。
  • 将较大的工作量分配给不同机器上的持久化副大副。

快速上手

  1. 1

    登录 GitHub CLI

    gh auth login
  2. 2

    克隆 firstmate 仓库

    git clone https://github.com/kunchenguid/firstmate
  3. 3

    进入克隆的目录

    cd firstmate
  4. 4

    启动受支持的代理工具(如 Claude Code),之后由 AGENTS.md 接管

    claude

使用前须知

  • 它不是独立应用,需要在受支持的编码代理工具(如 Claude Code、Grok 或 Pi)中运行。
  • 需要已登录的 GitHub CLI,以及 tmux 或其他受支持的会话后端。
  • 多个后端和功能(如 Zellij、cmux、T3 Code)被标记为实验性功能。

收录于专题

标签

常见问题

firstmate 是什么?
一套用于调度多个编码智能体的 agent distro:你只与一个“大副”对话,它把并行任务分派到隔离的 git worktree 和可见会话中。 firstmate 是一套可移植的指令、技能与辅助脚本目录,能把通用的终端编码智能体变成多智能体团队的协调者。它无需安装应用:克隆仓库后,在其中启动 Claude Code、Grok、Pi、Codex、OpenCode 等受支持的 harness,该会话即成为“大副”。你在对话中描述需求,大副会派出自主运行的“船员”,每个船员拥有独立的可见会话和干净的 git worktree,并持续监督直到产出 PR、批准的本地合并或调查报告。
firstmate 可以免费使用吗?用的什么许可证?
firstmate 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
firstmate 还在维护吗?
活跃维护中。firstmate 最近一次提交是在 2026年11月6日。
firstmate 适合用来做什么?
同时在多个仓库中推进多个修复或功能任务。 把代码库调研或审计交给智能体,并获得书面报告。 在单一对话中调度一组编码智能体,无需来回切换终端。 将较大的工作量分配给不同机器上的持久化副大副。
firstmate 怎么安装和运行?
登录 GitHub CLI: gh auth login 克隆 firstmate 仓库: git clone https://github.com/kunchenguid/firstmate 进入克隆的目录: cd firstmate 启动受支持的代理工具(如 Claude Code),之后由 AGENTS.md 接管: claude
在哪里获取 firstmate?
源代码和安装说明在 GitHub 上:https://github.com/kunchenguid/firstmate

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目