hivemind

hivemind

为编码 Agent 团队提供共享的实时计划。

你们分工后，各自的 Agent 开始开发；一小时后，每个 Agent 脑海中的计划都已过时：有人改了 User 架构，另一个人换了身份验证库，还有两个 Agent 在开发同一个端点。hivemind 会让团队所有 Agent 的计划保持同步，并在队友做出更改后，于每个 Agent 的下一次工具调用时将这些更改加入其上下文。

npx hivemind-agents install

每台机器上运行一次即可。无需服务、账号或房间代码：团队就是 git 仓库。

Agent 能看到什么

队友的 Agent 在你的 Agent 执行任务期间更改了 API。几秒后，在执行下一条命令后，你的 Agent 就会看到：

[hivemind] Teammates updated the shared plan since you last checked:
⚠️ BREAKING alice-3f2a1c updated contract: `User.id`: uuid (breaking) (was: int)
🎯 (overlaps files you touched) bob-91d0e4 added task: [doing] Signup form @bob-91d0e4
- alice-3f2a1c added decision: JWT in an httpOnly cookie, not localStorage [inferred]
Check whether your current work depends on the breaking changes above and adapt it.

在会话开始时，Agent 会获取完整计划：目标、契约（API 结构、架构、共享类型）、决策、任务分配情况以及待解决问题。

启动计划

只要向你的 Agent 提出要求即可，例如：“我们 3 个人这个周末要开发 X。为团队制定一个计划。” 它会在 hivemind 中记录目标、契约、决策和任务（任务尚未分配，但已注明依赖关系），每位队友的 Agent 都可以按键认领任务。你也可以使用 hivemind add 或在控制面板中（hivemind open）自行添加内容。

计划和笔记本

hivemind 将两类内容分开管理：

• 计划：目标、任务、契约、决策和待解决问题。即团队达成共识并正在推进的内容。
• 笔记本：状态、观察结果、测量数据、环境状态（“实验室机器在 14:00 前都很忙”“评估集上的精度为 0.82”“镜像已在本地构建，但未推送”）。Agent 会在会话开始时看到最近 24 小时的笔记，并可使用 notebook_get 搜索其余笔记。

在会话开始时，Agent 会优先看到最具操作性的内容（进行中的任务，然后是未开始的任务、契约、决策、问题和近期笔记）；较长的部分会受到长度限制，避免遗漏重要内容。已完成的任务和已回答的问题会自动从该视图中移除。

保持计划精简

只增不减的计划终将无人阅读。hivemind 会自行保持计划内容最新：

• **提取器记录更少内容：**契约仅涵盖其他人的工作所依赖的接口（API、架构、环境变量、共享类型），不包括组件属性或内部函数签名；决策仅包括项目级规则。它还会查看近期提交，因此已完成的工作会被标记为完成。
• 每日整理（仅当计划中有 40 项或更多未完成条目时，每个仓库每天最多一次，由当前活跃的 Agent 执行）：关闭已被取代、重复或不再成立的内容；根据提交记录标记已完成的任务；并将类似状态的决策移至笔记本。每项更改都会记录原因，运行情况也会记入笔记本。你可以使用 hivemind tidy（试运行）/ hivemind tidy --apply 手动运行。
• **过时的工作一目了然：**卡在进行中的任务会显示“（6 天未更新）”。

计划改变方向时

黑客马拉松期间，计划可能会改变。hivemind 会确保旧方向不会与新方向并存：

• 新目标必须说明与现有目标的关系：是取代现有目标，还是作为竞争方案。竞争目标会提示每位 Agent（“团队尚未选定，请询问用户”），直到有人解决冲突。
• 决策和契约可以取代早期条目；Agent 添加新条目时会看到现有条目，以便发现矛盾。后台提取器会移除工作明显已放弃的条目。
• hivemind review（或 plan_review 工具）会让模型检查整个计划中的矛盾并提出修正建议（约 15 秒）。

工作原理

 your agent ── hooks ──► hivemind ──► .git/hivemind/state.json (local cache, read in ~30 ms)
                            │
                  background daemon: push your ref, fetch everyone's (every 3 s while active)
                            │
                  origin: refs/hivemind/<member>   (hidden refs, never branches)

• 通过 git 同步。 每个人的计划条目都保存在现有远程仓库中各自的隐藏引用 (refs/hivemind/<member>) 上。没有人会写入其他人的引用，因此不会发生合并冲突。分支、PR 和工作树都不会受到影响。
• 更新会自动送达。 钩子会在会话开始时添加完整计划，之后只添加自 Agent 上次查看以来的变更，并优先显示最重要的内容。
• 计划会自动更新。 Agent 完成一轮操作时，后台提取器只会读取其转录中的新增部分，并提取队友需要了解的信息：契约、决策和任务进度，每项都附有引文作为依据。Agent 也可以通过 MCP 工具（contract_publish、decision_log、task_add、task_claim，等等）主动发布，并会收到紧急事项提示。
• 工作不会漏记。 Agent 首次编辑文件前，如果没有正在进行的任务，就会被要求领取一个任务（并显示尚未领取的任务）。一轮操作修改了文件后，如果 Agent 和提取器都没有记录任何信息，就会收到更新任务的提醒。
• 更新会在几秒内送达。 通常从一个 Agent 做出变更到另一台机器收到更新需要 2–5 秒，随后会在该 Agent 下次调用工具时显示。

支持的 Agent

Agent	启动时提供计划	任务期间提供更新	自动提取	备注
Claude Code	✅	✅ 每次提示词和工具调用时	✅
Codex CLI	✅	✅ 每次提示词和工具调用时	✅	在 Codex 中通过 /hooks 批准钩子一次（Codex 要求任何新钩子都必须这样操作）
Cursor	✅	✅ 每次工具调用后	✅	根据 Cursor 的钩子文档构建；尚未在实际 Cursor 会话中测试

install 会检测你使用了其中哪些 Agent，并为它们逐一配置（使用 --only=claude,codex 进行选择）。

Claude Code 插件（替代方案）

/plugin marketplace add Leonhest/hivemind
/plugin install hivemind@hivemind

使用相同的钩子和 MCP 工具，无需 npm。请使用插件或 npx … install，不要两者同时使用。

命令

install 会将 hivemind 命令添加到 PATH 中（也可以使用 npx hivemind-agents <command>）。

hivemind status       who's in the plan, last sync
hivemind plan         print the shared plan
hivemind open         live dashboard in your browser (and a form to add to the plan)
hivemind review       check the plan for contradictions
hivemind tidy         find finished, duplicate and outdated entries (--apply to clean up)
hivemind add <goal|task|contract|decision|question> <key> <text> [--breaking]
hivemind doctor       check that everything is wired up
hivemind disable      turn hivemind off for this clone (hivemind enable to undo)
hivemind uninstall    remove hooks and MCP config (your repos' plan data is left alone)

隐私与费用

• 你的计划数据绝不会离开你的 git 托管平台。 hivemind 不提供服务端。任何拥有仓库读取权限的人都能读取其中的计划引用，也就是能读取代码的那些人。
• 公开仓库 = 公开计划。 hivemind 会检测公开的 GitHub 仓库，并告知你的 Agent（以及 hivemind status），以免有人感到意外。不希望如此？hivemind disable 会为该克隆关闭此功能；hivemind enable 则会重新启用。
• 敏感信息会被清除。 每条计划内容在写入前都会检查是否包含密钥、令牌、密码和连接字符串凭据；提取器也会被要求排除凭据、个人信息、客户名称和未修复的安全问题。
• 提取在你的机器上使用你自己的 Agent 登录信息运行。 它会使用你现有的订阅或 API 密钥调用 Haiku 版 claude -p（如果你只有 Codex，则调用 codex exec）：按 API 价格计费，每次提取约 $0.005；或者只消耗订阅用量中的一小部分。设置 HIVEMIND_EXTRACTOR_BACKEND=none 即可关闭提取功能，仅使用 MCP 工具。
• 只有包含实际工作的转录新增部分（请求或代码变更）才会被提取。只读探索会跳过。

要求与限制

• 需要 macOS 或 Linux、Node 20+、git，以及一个你可以推送到的、配置了 origin 远程的仓库（没有推送权限仍可接收更新，但无法分享自己的更新）。
• 已针对 GitHub 测试。其他接受自定义引用的托管平台应该也能使用；尚未测试 GitLab。
• 如果不在 git 仓库中，或没有 origin，hivemind 就不会介入。

故障排除

运行 hivemind doctor。日志位于每个仓库的 .git/hivemind/ 中（hivemind.log、daemon.log、extract.log）。

许可证

MIT