firstmate：用单个主控 Agent 指挥多 Agent 协作完成工程任务

kunchenguid/firstmate · Talk to one agent. Ship with a crew.

GitHub原文发布未知首次收录 2026-09-15上架 2026-09-27 09:01

ELI5：它是什么，解决什么问题

firstmate 是一个「agent distro」（Agent 发行版），以目录形式提供指令、技能、工具、策略与状态约定，把通用终端编码 Agent 变成专门的主控 Agent（first mate）。用户只与一个主控 Agent 对话，由它调度、监督并汇报多个自主工作 Agent：每个任务在独立 git worktree（treehouse 或 Orca 托管）中运行、在可见会话后端（tmux、herdr、zellij、cmux、Orca 终端）中展示，通过零 token 的事件驱动监控在需要时唤醒主 Agent，最终交付 PR、经批准的本地合并或独立的调研报告。支持可选 secondmates（本地或 SSH 可达主机的持久子主控）、项目模式（no-mistakes、direct-PR、local-only 及 +yolo 合并自主标志）、可选的 Relay 以响应 X/Discord 公开提及，状态落盘，会话可随时重启并重新对账。

# 终端 # Agent 与自动化 # human-in-the-loop # 多智能体系统 # 工作树隔离

核心能力与快速开始

★ 5938 · Shell

能做什么: 以「Agent 发行版」形态提供一份可移植目录（AGENTS.md、内置 firstmate 技能与辅助脚本），让受支持的终端编码 Agent 成为主控 first mate。主控负责：把请求派发给各自拥有独立会话端点与 git worktree 的工作 Agent；通过事件驱动、零 token 的 bash 监控监督整个机队，仅在需要用户决策时唤醒；交付已完成的 PR、经批准的本地合并或独立调研报告。支持两种任务形态：ship（交付授权变更）与 scout（产出独立调研报告）。项目模式可配置为 no-mistakes、direct-PR 或 local-only，并可加 +yolo 合并自主标志。可选 secondmates 为本地或整机远程（SSH 可达主机）的持久子主控，各自拥有 FM_HOME、状态、项目与会话锁，并带有受保护的更新与恢复逻辑。可选 Relay 通过本地 .env 配对令牌让机队回应 X 与 Discord 的公开提及。内置用户可调用技能包括 /afk、/quiet、/ahoy、/bearings、/updatefirstmate、/stow。状态全部落盘并保存在会话后端中，会话可被杀死后重新对账继续。
适用场景: 适用于希望并行推进同一仓库或跨仓库的多项工程任务（缺陷修复、排查、计划、审计）的场景，由单一对话入口替代手工切换多个 Agent 标签页、跨仓库复制上下文、追踪失败测试所在终端等操作。也适用于需要在可观察、可介入的会话窗口中监督自主 Agent 机队的团队；需要把任务派发到 SSH 可达的远程主机时可用 secondmates；需要让机队对外（X/Discord）公开提及做可回滚响应时可用可选 Relay。
项目形态: 开发框架
部署方式: 本地：克隆仓库后在其目录内启动受支持的编码 Agent 即可（仓库本身即发行版，无应用需安装）。运行后端默认 tmux，也可选用 herdr、zellij、Orca、cmux。可选 secondmates 支持本机或 SSH 可达远程主机的整机 home。未说明容器化或托管服务等部署方式。
主要依赖: 要求已验证的主 Agent 运行时：Claude Code、Grok、Pi、pi-signed、Oh My Pi（omp）、Codex、OpenCode 或 Cursor Agent CLI；需要 Git 与经 gh auth login 认证的 GitHub CLI；需要所选运行后端的 CLI 及依赖（tmux 为参考默认）。首次运行主 Agent 会检测并在用户同意后安装缺失的受支持工具。具体环境变量、FM_HOME 与后端配置参见文档。
使用限制: 材料未说明具体硬件、性能与 API 成本；未说明各项功能在不同运行时下的完整兼容性边界，仅提及 Codex、OpenCode 使用受限的前台检查点或 TUI 插件，监控权衡多于三个共同推荐运行时；Cursor Agent CLI 需以 --trust 交互式启动，其无头模式 cursor-agent -p 没有回合结束钩子；codex-app 目前还不是运行时后端。未说明是否可商用、许可限制以外的使用条件（许可证为 MIT）。
许可证: MIT
最近推送: 2026-09-15 06:40

官方入门核对 README 依据 ↗

资料检查：2026-09-15 07:00 · 卡片整理：2026-09-27 09:00
卡片由 AI 根据仓库资料整理，未进行安装或运行验证 · 本次更新未完成，保留上次成功内容

职业应用

程序员

程序员可用 firstmate 作为主控 Agent 工作流：与单个主控 Agent 对话，由它调度多个自主编码 Agent 并行处理修复、调研、计划、审计等任务，每个任务在独立 git worktree 中运行，最终交付 PR、经批准的本地合并或调研报告。

查看内容依据

You talk to a single agent - the first mate - and it runs the crew for you: spawning autonomous agents in a visible session backend, giving each a clean git worktree, supervising them to completion, and handing you finished PRs, approved local merges, or standalone investigation reports.

官方使用入口 ↗

由 AI 根据来源材料整理，未进行安装或运行验证

相似资源

skills：为 Claude Code 和 Codex 打包可移植智能体技能插件市场

该项目把智能体技能以插件市场形式打包，使同一份检出可同时安装到 Claude Code 和 Codex。包含三个插件：ship 端到端驱动单个改动（issue、实现、自带审查、交付或合并）；shipyard 在后台终端批量运行并监督多个 ship（每个改动一个 git worktree、定时状态表、停滞与上下文上限看门狗）；council 让多个智能体会话（Claude Code、Codex、Antigravity）就单一问题轮流发言、机械关闭异议并产出决策记录。ship 会自行发现仓库的 forge、默认分支、分支命名、检查命令与合并策略。

Bruce：自托管的跨平台消息应用个人 AI 助理

Bruce 是一个用 Go 编写的自托管个人 AI 助理，可接入 WhatsApp、Discord、Telegram 和内置网页聊天，由 Claude、Gemini 或 OpenAI 模型驱动。它通过多轮自主 Agent 循环调用 15 种以上工具（网页搜索、bash、文件、Git/GitHub、Gmail、日历、Docs、Notion、Trello、n8n、HTTP 客户端等），支持定时主动任务与告警、生成并托管独立 HTML 工件，并配有用于管理会话、日程、工件和设置的网页面板与 REST API。所有数据保存在本地基础设施的 SQLite 与 Redis 中。

HR-Recruitment-AI-System：AI 智能体驱动的招聘全流程平台

这是一个基于 AI 智能体的招聘平台，覆盖写职位描述、简历解析与筛选、候选人面试、录用推荐等环节，最终由人工招聘官做决定。系统包含多角色评审小组、对比视图、AI 面试评分卡、候选人问答机器人、招聘官收件箱、外联邮件（含日历文件）、Ask-HR、技能差距教练、实时 Agent 图、仪表盘漏斗与活动时间线、内置评测页与 PDF 候选人报告，并提供演示数据集和 5 分钟演示脚本。技术栈为 Next.js + TypeScript 前端、Python 3.11 + FastAPI + SQLAlchemy(SQLite) 后端，LLM 通过 Groq 的 OpenAI 兼容 API（也可用本地 Ollama）。

agent-toolkit：面向多编码代理的 Agent Skills 集合与隔离 EC2 编码任务工厂

agent-toolkit 是一个与具体模型供应商无关的代理式工程栈，由两部分组成：一是面向 Claude Code、Cursor、Codex CLI 和 Antigravity CLI 的精选 Agent Skills 与统一工作方式（含 poteto-mode 以及 swarm、interrogate、figure-it-out 等可选技能）；二是 factory 控制器，可在一次性的隔离 EC2 worker 上执行单个编码任务，完成克隆仓库、修改、运行检查、推送分支并开启 PR，并把每步进度发到 Slack 后删除 worker。仓库也列出其他技能目录与 quota-axi 等推荐技能。

这是基于来源内容整理的摘要。原文链接失效后，本页摘要和讨论仍会保留。