hivemind

hivemind

コーディングエージェントのチームで共有する、リアルタイムの計画です。

作業を分担し、各自のエージェントが作業を進めます。ところが1時間後には、エージェントが把握している計画が古くなっています。誰かがUserスキーマを変更し、別の人が認証ライブラリを切り替え、2つのエージェントが同じエンドポイントを作っています。hivemindは、チームのすべてのエージェント間で計画を同期し、チームメイトの変更を、エージェントが次にツールを呼び出したときにそのコンテキストへ反映します。

npx hivemind-agents install

マシンごとに一度実行するだけです。サーバーもアカウントもルームコードも必要ありません。チームとはgitリポジトリのことです。

エージェントが確認できる内容

あなたが作業中に、チームメイトのエージェントがAPIを変更します。数秒後、次のコマンドを実行すると、あなたのエージェントには次のように表示されます。

[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.

セッション開始時には、目標、契約（APIの形状、スキーマ、共有型）、決定事項、担当者、未解決の質問など、計画全体が表示されます。

計画の開始

エージェントに「今週末、3人でXを作ります。チームの計画を作って」と頼むだけです。目標、契約、決定事項、タスク（未割り当て、依存関係付き）がhivemindに記録され、チームメイトの各エージェントはキーを使ってタスクを1つ引き受けられます。hivemind addを使うか、ダッシュボード（hivemind open）で自分で追加することもできます。

計画とノートブック

hivemindでは、次の2つを分けて管理します。

• 計画：目標、タスク、契約、決定事項、未解決の質問です。チームが合意し、実行している内容です。
• ノートブック：状況、観察結果、測定値、環境の状態（「実験用マシンは14:00まで使用中」「評価セットでの精度は0.82」「イメージはローカルでビルド済み、未プッシュ」など）です。エージェントはセッション開始時に過去24時間分のノートを確認し、残りはnotebook_getで検索できます。

セッション開始時には、最も対応が必要な内容（進行中のタスク、次に未着手のタスク、契約、決定事項、質問、最近のノート）の順にエージェントに表示されます。重要な情報が切り捨てられないよう、長いセクションには上限が設けられています。完了したタスクや回答済みの質問は、自動的にこの表示から除外されます。

計画を小さく保つ

大きくなる一方の計画は、読まれなくなります。hivemindは計画を自動で最新の状態に保ちます。

• **抽出する情報を減らします：**契約として記録するのは、他の人の作業が依存するインターフェース（API、スキーマ、環境変数、共有型）だけです。コンポーネントのpropsや内部関数のシグネチャは含めません。決定事項として記録するのも、プロジェクト全体に関わるルールだけです。また、最近のコミットも確認し、完了した作業を完了済みにします。
• 毎日の整理（未解決の項目が40件以上ある計画を対象に、リポジトリごとに1日最大1回、エージェントが稼働中のユーザーが実行します）では、古い内容で置き換えられた項目、重複した項目、事実に合わなくなった項目を終了し、コミットから完了したと判断できるタスクに完了済みの印を付け、状況を表すような決定事項をノートブックに移します。変更には理由が記録され、実行内容はノートブックに記録されます。hivemind tidy（ドライラン）／hivemind tidy --applyで手動実行することもできます。
• **停滞中の作業を確認できます：**進行中のまま止まっているタスクには「(6d更新なし)」と表示されます。

計画の方向性が変わったとき

ハッカソンの途中で計画が変わることもあります。hivemindは、古い方向性が新しい方向性と並んで残らないようにします。

• **新しい目標を追加するときは、既存の目標との関係を明記する必要があります。**既存の目標を置き換えるのか、競合する提案なのかを示します。競合する目標は、誰かが決着をつけるまで、すべてのエージェントに「チームではまだ選択していません。ユーザーに確認してください」と表示されます。
• 決定事項や契約は、以前のものを置き換えることができます。また、エージェントが新しい項目を追加するときには既存の項目も表示されるため、矛盾に気づけます。バックグラウンドの抽出処理は、作業で明らかに採用されなくなった項目を削除します。
• 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 で同期します。 各メンバーのプラン項目は、既存のリモート上にある各自の非表示 ref （refs/hivemind/<member>）に保存されます。誰かが他の人の ref に書き込むことはないため、 マージコンフリクトは発生しません。ブランチ、PR、作業ツリーには一切触れません。
• 更新は自動で届きます。 フックがセッション開始時にプラン全体を追加し、その後はエージェントが最後に確認してから変更された内容だけを、重要度の高い項目から順に追加します。
• プランは自動で更新されます。 エージェントがターンを終えると、バックグラウンドの抽出機能がトランスクリプトの新しい部分だけを読み取り、チームメイトに必要な契約、決定事項、タスクの進捗を、根拠となる引用とともに抽出します。エージェントは MCP ツール（contract_publish、decision_log、task_add、task_claim、…）を使って明示的に公開することもでき、緊急の内容についても通知されます。
• 作業が記録されずに済むことはありません。 エージェントが初めてファイルを編集する前に、進行中のタスクがなければ、タスクを引き受けるよう求められ、未割り当てのタスクが表示されます。ファイルを変更したターンの後、エージェントも抽出機能も何も記録していない場合は、タスクを更新するよう促されます。
• 更新は数秒で届きます。 通常、あるエージェントが変更してから別のマシンに届くまで 2〜5 秒で、そのエージェントの次回のツール呼び出し時に表示されます。

対応エージェント

エージェント	開始時のプラン	タスク中の更新	自動抽出	備考
Claude Code	✅	✅ 各プロンプトとツール呼び出しのたび	✅
Codex CLI	✅	✅ 各プロンプトとツール呼び出しのたび	✅	Codex で /hooks を使ってフックを一度承認してください（Codex では新しいフックごとに承認が必要です）
Cursor	✅	✅ 各ツール呼び出しの後	✅	Cursor のフックに関するドキュメントに基づいて作成されています。実際の Cursor セッションではまだテストされていません

install はこれらのうちインストール済みのエージェントを検出し、それぞれを設定します（選択するには --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 サーバーはありません。リポジトリへの読み取りアクセス権を持つ人は、コードを読める人と同じように、プランの ref を読めます。
• パブリックリポジトリではプランも公開されます。 hivemind は公開 GitHub リポジトリを検出し、エージェントと hivemind status に通知するため、誰も不意を突かれることはありません。望まない場合は、hivemind disable でそのクローン上では無効にし、hivemind enable で再び有効にできます。
• シークレットは除去されます。 すべてのプラン項目について、書き込む前にキー、トークン、パスワード、接続文字列の認証情報がないか確認します。また、抽出機能には、認証情報、個人情報、顧客名、未修正のセキュリティ問題を除外するよう指示します。
• 抽出は、各自のエージェントのログイン情報を使ってマシン上で実行されます。 既存のサブスクリプションまたは API キーを使い、Haiku で claude -p を呼び出します（Codex しかない場合は codex exec を呼び出します）。API 料金では抽出 1 回あたり約 $0.005、サブスクリプション利用量ではその一部程度です。HIVEMIND_EXTRACTOR_BACKEND=none を設定すると無効になり、MCP ツールのみを使用します。
• 実際の作業（依頼またはコード変更）を含むトランスクリプトの新しい部分だけが抽出されます。読み取り専用の調査はスキップされます。

要件と制限

• macOS または Linux、Node 20 以上、git、そしてプッシュ可能な origin リモートがあるリポジトリ（プッシュ権限がなくても更新は受け取れますが、自分の更新は共有できません）。
• GitHub でテスト済みです。カスタム ref に対応する他のホストでも動作するはずですが、GitLab ではまだテストされていません。
• git リポジトリ内にない場合、または origin がない場合、hivemind は動作しません。

トラブルシューティング

hivemind doctor を実行してください。各リポジトリの .git/hivemind/ にログ（hivemind.log、daemon.log、extract.log）があります。

ライセンス

MIT