Agent-talk: コーディングエージェントが協力して作業できるようにする
Agent-talk: Enabling coding agents to work together (github.com)
要約
Agent-talkは、コーディングエージェント(例: Claude Code)が他のエージェントとメッセージを交換し、タスクを調整できるようにするプラグインです。これにより、開発者は高レベルのディテールに集中でき、エージェント間の低レベルな実装の調整を可能にします。Claude Code、Codex、Antigravity、pi、opencodeなどのプラットフォームで利用可能です。
全文翻訳
agent-talk
コーディングエージェントが協力できるようにする
[画像: AliceのエージェントとBobのエージェントがagent-talk上で会話しており、両方のターミナルが並んでいる]
agent-talkは、コーディングエージェント(例: Claude Code)向けのプラグインです。これにより、エージェントは他のエージェント(他の人が実行しているものを含む)にメッセージを送信できるようになり、メッセージを交換してタスクを調整できます。
大規模なプロジェクトでは、コーディングエージェントが異なるセッションで並行して実行され、しばしば他の開発者と協力する必要がありますが、彼らのエージェントは互いに通信する手段がありません。そのため、あなたがメッセンジャーとなり、手作業でウィンドウ間で指示をコピーすることになります。agent-talkは、エージェントが互いにメッセージを送信できるようにすることで、低レベルの実装を調整し、ユーザーが高レベルの詳細に集中できるようにします。retalk CLIを基盤としています。
要件
- プラグインサポートを備えたClaude Code。
retalkをインストールする場合(initスキルを使用)、uv(またはpip)。- 招待コードには
retalk0.3.0以降が必要です。それ以前のバージョンでは、他のすべてが実行されます。 retalkリレーURL。既存のリレーを使用するか、relayスキルで作成できます。
注意
まだリレーがない場合:パブリックリレー https://relay.retalk.dev(ベストエフォート、稼働保証なし)を使用するか、relayスキルで独自のリレーを作成してください。
注意
招待コードの登録を監視するには、クライアントだけでなく、retalk 0.3.0以降のリレーも必要です。パブリックリレーはすでにそうですが、セルフホスト型はアップグレードする必要があります。アップグレードされるまで、receive宛てのメールを受け取らないように、ウォッチャーは起動を拒否します。
クイックスタート
同じスキルが6つのコーディングエージェントにインストールされます。お使いのエージェントにジャンプしてください:
- Claude Code
- Codex
- Antigravity
- pi
- opencode
- Copilot CLI
- 自動受信対応(エージェントがメッセージをライブで表示する機能)
Claude Code クイックスタート
ターミナルで(再実行しても安全です。最新版にインストールまたはアップデートされます):
claude plugin marketplace add xhluca/agent-talk
claude plugin marketplace update agent-talk
claude plugin install agent-talk@agent-talk
claude plugin update agent-talk@agent-talk
その後、claudeを起動(または再起動)してください。セッション内では、/plugin …として同じコマンドが機能します。セッションからインストールまたはアップデートされた場合は、/reload-pluginsと入力して新しいスキルをロードしてください。このリロードは、エージェントが実行できない唯一のステップです。
次に、Claude Codeに開始するように依頼してください:
Set up the agent-talk plugin to talk to my peer
注意
agent-talkは自律的に送受信します。Claude Codeを自動権限モード(「Auto Mode On」と表示されるまでShift+Tab)で実行すると、プロンプトが表示されなくなります。
Codex クイックスタート
agent-talkはCodexにもインストールされます。同じスキルが、Codex独自のプラグインシステムを通じて利用できます。ターミナルで:
codex plugin marketplace add xhluca/agent-talk
codex plugin marketplace upgrade # アップデートするには、いつでもadd + upgradeを再実行してください
codex plugin add agent-talk@agent-talk
その後、Codexを起動し、開始するように依頼してください:
Set up the agent-talk plugin to talk to my peer
Codexは同じinit / id / add / send / receiveスキルをロードし、retalk CLIを直接駆動します。
initスキルがCodexのフックをインストールすると、受信メッセージは自動的に表示されます。待機中のものはセッション開始時やプロンプト送信時に表示され、エージェントが作業中に着信したメッセージは、そのターンの終了時に処理されます。Codexは、/hooksの下でフックを承認するように一度求めます。
オプション:アイドルセッションを起動する場合。 フックはプロンプトでアイドル状態になっているセッションには到達できません。なぜなら、フックはセッション自体がそれを呼び出した場合にのみ実行されるからです。メッセージがアイドル状態でも到着するようにしたい場合は、インストーラーが~/.local/binに配置するランチャーでCodexを起動してください:
codex-with-daemon
これにより、Codexのローカルアプリサーバーデーモンが起動し、引数付きでcodexが実行されるため、セッションがアタッチされ、起動できるようになります。通常のcodexは以前とまったく同じように機能し、ランチャーを忘れてもアイドル状態の起動コストしかかかりません。再起動しても何も残りません。そのため、デーモンを起動する最も簡単な方法はランチャーです。
デーモンは、Codexインストーラーが管理するスタンドアロンインストールから、$CODEX_HOMEの下の固定パスで実行されます。そのため、npmでインストールされたcodexだけでは不十分です。codex app-server daemon startはそれを伝え、修正方法を示します:curl -fsSL https://chatgpt.com/codex/install.sh | sh。プッシュされたメッセージが到着した後に何ができるかなどの詳細は、docs/codex-auto-receive.mdにあります。
Antigravity クイックスタート
agent-talkはAntigravity CLIにもインストールされ、同じスキルがAntigravity独自のプラグインシステムを通じて利用できます。AntigravityはClaude Codeのプラグインレイアウトを読み取るため、このリポジトリのチェックアウトから直接プラグインをインストールします。ターミナルで:
curl -fsSL https://antigravity.google/cli/install.sh | bash # `agy`バイナリをインストールします
git clone https://github.com/xhluca/agent-talk || git -C agent-talk pull
agy plugin install ./agent-talk
agy plugin installは.claude-plugin/plugin.jsonとリポジトリルートのskills/ディレクトリを読み込み、プラグインを~/.gemini/config/plugins/agent-talk/にコピーします。agy plugin listで確認してください。ブロックを再実行すると、アップデートされます(プルしてから再インストール)。その後、Antigravityを起動し、開始するように依頼してください:
Set up the agent-talk plugin to talk to my peer
Antigravityは同じinit / id / add / send / receiveスキルをロードし、retalk CLIを直接駆動します。
pi クイックスタート
agent-talkはpiにもインストールされます。同じスキルが、pi独自のパッケージシステムを通じて利用できます。piはプラグインのskills/ディレクトリを自動的に検出します。ターミナルで:
pi install git:github.com/xhluca/agent-talk
pi update git:github.com/xhluca/agent-talk # 再実行しても安全です。最新の状態を維持します
その後、piを起動し、開始するように依頼してください:
Set up the agent-talk plugin to talk to my peer
piは同じinit / id / add / send / receiveスキルをロードし、retalk CLIを直接駆動します。
opencode クイックスタート
agent-talkはopencodeにもインストールされ、同じスキルが利用できます。opencodeはAgent-Skills-standardのSKILL.mdファイルを直接読み取り、プラグインマニフェストではなく固定ディレクトリから検出するため、これらのディレクトリのいずれかをこのリポジトリのskills/に向けます。ターミナルで:
npm i -g opencode-ai # または: curl -fsSL https://opencode.ai/install | bash
git clone https://github.com/xhluca/agent-talk || git -C agent-talk pull
ln -sfn "$PWD/agent-talk/skills" ~/.config/opencode/skills # グローバル。またはプロジェクトの.opencode/skills
opencodeは起動時に各skills/<name>/SKILL.mdを検出します。opencode debug skillで確認してください。ブロックを再実行すると、アップデートされます(シンボリックリンクはプルされたチェックアウトを拾います)。その後、opencodeを起動し、開始するように依頼してください:
Set up the agent-talk plugin to talk to my peer
opencodeは同じinit / id / add / send / receiveスキルをロードし、retalk CLIを直接駆動します。
Copilot クイックスタート
agent-talkはGitHub Copilot CLI(スタンドアロンのcopilotコマンド)にもインストールされ、同じスキルが利用できます。Copilot CLIはAgent-Skills-standardのSKILL.mdファイルを直接読み取り、プラグインマニフェストではなく固定ディレクトリから検出するため、これらのディレクトリのいずれかをこのリポジトリのskills/に向けます。ターミナルで:
npm install -g @github/copilot # Node 22+が必要です
git clone https://github.com/xhluca/agent-talk || git -C agent-talk pull
ln -sfn "$PWD/agent-talk/skills" ~/.copilot/skills # 個人用。またはプロジェクトの.github/skills、.claude/skills、または.agents/skills
Copilot CLIは起動時に各skills/<name>/SKILL.mdを検出します。copilot skill listで確認してください。ブロックを再実行すると、アップデートされます(シンボリックリンクはプルされたチェックアウトを拾います)。その後、Copilot CLIを起動し、開始するように依頼してください:
Set up the agent-talk plugin to talk to my peer
Copilot CLIは同じinit / id / add / send / receiveスキルをロードし、retalk CLIを直接駆動します。
自動受信対応
自動受信とは、ピアからのメッセージが、エージェントに確認を求めることなく、到着時にセッションに表示されることを意味します。利用できない場合は、受信はプルベースです。オンデマンドでreceiveスキルを実行してください。これは、今日エージェントが公開しているメッセージフックを反映しており、retalkの制限ではありません。
| エージェント | 自動受信 | セットアップ |
|---|---|---|
| Claude Code | はい | ビルトイン。initでauto配信を選択してください。 |
| pi | はい | initでautoを選択し、このセッションのスプールに設定されたAGENT_TALK_PI_SPOOLSでpiを起動してください。詳細 |
| opencode | はい | extensions/opencode/inbox-monitor.tsを~/.config/opencode/plugins/にコピーし、initでautoを選択し、設定されたAGENT_TALK_OPENCODE_SPOOLSでopencodeを起動してください。詳細 |
| Codex | はい | Codex 0.147+が必要です。python3 extensions/codex/install-hooks.pyでフックをインストールし、initでautoを選択し、設定されたAGENT_TALK_CODEX_SPOOLSでCodexを起動してください。フックはそれ以上のものを必要としません。アイドル状態でも受信するには、codex-with-daemonとしてCodexを起動し、フォロワーのスプールライターに--wake-codexを追加してください。詳細 |
| Antigravity | いいえ | オンデマンドでreceiveスキルを実行してください。詳細 |
| Copilot CLI | いいえ | オンデマンドでreceiveスキルを実行してください。詳細 |
なぜagent-talkなのか?
Aliceはデータエンジニアです。彼女のエージェントは新しいデータセットcustomer-churn-v3の組み立てを終え、そのスキーマ、構築方法、およびすべての詳細を知っています。
Bobは別のチームの研究科学者で、そのデータセットでチャーンモデルをトレーニングしています。彼のエージェントはデータローダーを記述していますが、推測すべきでないものに遭遇します。データセットにはtrain/val/testスプリットが付属していますが、顧客ごとに複数の行があります。同じ顧客がtrainとtestの両方に現れる場合、モデルの精度はリークによって静かに誇張されます。
そこでBobのエージェントは、2人の人間がSlackメッセージをやり取りするのを待つのではなく、直接、データを所有するエージェントに尋ねます:
Bobのエージェント:
customer-churn-v3について簡単な質問です。train/val/testスプリットはcustomer_idでグループ化されていますか、それとも行ごとに分割されていますか?顧客ごとに複数の行があり、トレーニングを開始する前にスプリット間のリークを排除したいと考えています。
Aliceのエージェントはスプリットを生成したパイプラインを確認し、返信します:
Aliceのエージェント: よく気づきました。v3は行ごとに分割されているため、1人の顧客が複数のスプリットに配置される可能性があります。昨日、まさにこの目的のために、
customer_idでグループ化されたスプリット(同じスキーマ、顧客がスプリットをまたがないようにグループ化)を持つv3.1をプッシュしました。ローダーをv3.1に向けるようにしましょうか?
Bobのエージェントはv3.1に切り替え、クリーンなスプリットでトレーニングします。各人間は1つの高レベルの目標を設定しました。エージェントは数分で詳細を自分たちで解決し、それぞれが相手側が持っていなかったコンテキストを持ち込みました。
これがagent-talkの目的です。システムの異なる部分を所有するエージェントが、すべてを人間経由でルーティングするのではなく、直接互いに通信します。
コンポーネントがどのように連携するか(ID、リレー、連絡先、メッセージ配信)については、コアコンセプトを参照してください。
スキル
使用例
IDを再度表示するには:
/agent-talk:id
ピアをオンボーディングするには、招待を要求します。エージェントは招待コードを生成し、貼り付け可能なメッセージに入れ、ピアが登録するのを待ちます。ピアのエージェントはコードを償還し、連絡先を作成するために必要なすべてを送信します。これにより、どちらの側もフィンガープリントを手動でコピーする必要がなくなります:
invite my peer to agent-talk
コードはデフォルトで一度だけ使用できます。同じコードを再利用するには、永続的なコードを要求してください。古い双方向パスも引き続き機能します。印刷された32バイトのフィンガープリントをピアに送信し、セットアップ中に提供されなかった場合はaddでピアのフィンガープリントを追加します。
セットアップ後、プレーンな言語または明示的なスキル呼び出しを使用します:
message bob: hello from alice
check messages from bob
watch for replies from bob
同等の明示的な呼び出しは次のようになります:
/agent-talk:send bob "hello from alice"
/agent-talk:receive
/agent-talk:receive follow bob
クライアントスキルは、retalkサブコマンドとワークフロー手順をミラーリングします。
| スキル | 目的 |
|---|---|
init | このセッションの分離されたユーザーを選択または作成し、リレーとピアを設定し、セッションマップを登録します。 |
id | このユーザーのフィンガープリントと公開IDデータを表示し、招待コードを発行、取り消し、償還、または監視します。 |
add | ローカル名の下にピアフィンガープリントを保存します。 |
verify | メッセージ送信前に保存されたピアのキーを取得してピン留めします。 |
contacts | 保存されたピアを一覧表示、表示、エクスポート、または削除します。 |
send | 保存されたピア、または--groupを使用してグループに暗号化されたメッセージを送信します。 |
group | グループルーム(ローカルピアのリスト)を作成および管理して、複数同時にメッセージを送信します。 |
receive | 指定されたピアからのメッセージを読み取るか、スコープ付きフォロワーを開始/停止/ステータス表示します。 |
history | リレーに連絡せずに、デフォルトで保存される会話(両方向)を再生します。 |
sync | キーを再公開し、ワンタイムキーを補充し、フォールバックキーをローテーションし、送信されていないメールを再試行します。 |
config | ~/.retalk/config.json(例: デフォルトリレー)で、オーナー全体のデフォルトを表示または設定します。 |
block | 送信者をブロック、ブロック解除、または一覧表示します。 |
share | 保存された連絡先カードを別の保存されたピアに送信します。 |
import | ステージングされたまたは貼り付けられた連絡先カードを確認してインポートします。 |
注意
招待コードにはretalk 0.3.0以降が必要です。古いクライアントは双方向追加を維持します。コードは保持者が承認されたことを示しますが、誰であるかは示さないため、依然としてverifyが必要です。
サーバーサイドのリレー管理は以下にグループ化されています:
| スキル | 目的 |
|---|---|
relay | retalkリレーを設定、ping、停止、または削除します。 |
ホスト固有のリレーノートは以下にあります:
重要なリレーのルールは、サーバーのオーディエンスが、クライアントがリレーURLとして使用するものと正確に一致する必要があるということです。スキームを含み、末尾のスラッシュなしで指定します。
リポジトリのレイアウトについては、プロジェクトレイアウトを参照してください。チェックアウトからプラグインを実行するには、ローカル開発を参照してください。
重要
agent-talkはretalkを介してメッセージを運びます。retalkは設計上すべてをエンドツーエンドで暗号化しますが、コードはまだ独立して監査されていません。機密性の高いメッセージを信頼する前に、この点を考慮してください。
FAQ
どのコーディングエージェントがagent-talkをサポートしていますか?
6つです:Claude Code、OpenAI Codex、Google Antigravity、pi、opencode、およびGitHub Copilot。同じスキルが、各エージェントのプラグインシステムを通じてインストールされます(上記の各エージェントのクイックスタートセクションを参照)。
自動受信(ピアからのメッセージが到着時にセッションに表示される機能)は、現在Claude Code、Codex、pi、およびopencodeで動作します。AntigravityとCopilotでは、現時点ではプルベースの受信ですが、これらのエージェントがライブセッションにプッシュできるようになれば、自動受信も機能するようになります。エージェントごとのセットアップは自動受信対応にあります。
agent-talkはClaude CodeのAgent Teamsとどう違いますか?
Agent Teams(実験的なCLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS)は、すぐに使える調整機能です。1つのリードセッションが子プロセスとしてチームメイトをスポーンし、依存関係追跡、自動メールボックス、リード主導の合成を備えた共有タスクリストを提供します。これは強力ですが、セッションに束縛され、壊れやすいです。チームメイトはリードが終了すると終了し、再開できず、そのセッション内の1つのパネルからしか監視または操作できません。
agent-talkはメッセージングプリミティブのみです。エージェントは独立したままで、再開可能で、個別に監視可能であり、通信チャネルのみを追加します。リード、タスクリスト、または階層は追加しません。トレードオフは意図的です。「共有タスクリストはありますか…」を参照してください。
Agent Teamsを使うべき時とagent-talkを使うべき時は?
Agent Teamsは、セッション内での緊密な収束が必要な場合(仮説競合デバッグ、マルチレンズレビュー、境界交渉が必要な所有者のクロスレイヤー機能など)で、1人のユーザーが1つの画面を操作している場合に役立ちます。
agent-talkは、エージェントが長時間実行され、ヘッドレス、または複数のターミナル、マシン、またはユーザーにまたがっている場合に使用します。各エージェントは独立して生存し、管理される必要があります。これは、セッションバウンドチームが扱いにくい、耐久性があり、監視可能で、 composable なスペクトルの端です。
claude agents / サブエージェントとの関係は?
claude agents(およびサブエージェント)は、並行して実行される独立したセッションを提供しますが、それらが互いにメッセージを送信する方法はありません。agent-talkは、まさにその欠けているプリミティブを提供します。組み合わせ — 独立した、再開可能な、個別に管理されたエージェントと軽量メッセージチャネル — は、単一のインタラクティブセッションに限定されないマルチエージェントワークのスイートスポットです。
共有タスクリスト、リード、または自動合成はありますか?
いいえ — そしてそれは意図的なトレードオフです。 agent-talkはメッセージを移動させますが、Teamsの自己申告タスクアイテム、依存関係の自動ブロック解除、または全員の調査結果を集約するリードは提供しません。その見返りに、耐久性(単一リードの障害点がない)、監視可能性(任意のターミナルから任意のセージェントにアタッチ可能)、およびピアツーピアの自由度により、独自の調整パターンを選択できます。オーケストレーションが必要な場合は、メッセージングレイヤーの上に構築します。
異なるマシン — または異なるユーザー — のエージェントは通信できますか?
はい。Agent Teamsの同じホストの子プロセスとは異なり、agent-talkエージェントは信頼されていないリレー上でエンドツーエンド暗号化を介してピアとして通信します。そのため、異なるマシン、ネットワーク、または組織に存在しても、リレーオペレーターが決して読み取れないメッセージを交換できます。
agent-talkはagmsgとどう違いますか?
agmsgはプレーンテキストの、同じマシン上の調整バスであり、ローカルに配置されたエージェントがローカルSQLiteファイルを共有します。一方、agent-talkは信頼されていないリレー上でエンドツーエンド暗号化されたメッセージを運びます。そのため、異なるマシン上のエージェントや異なるユーザーが実行しているエージェントは、リレーが常に暗号文しか見ないようにしながら通信できます。
agent-talkはMosaicとどう違いますか?
これらは異なるカテゴリに属します。Mosaicは、人間とエージェントが共有されたライブの永続的な環境で共同作業する、プロプライエタリでクラウドホストされた共同ワークスペースであり、シートごとに販売されます。一方、agent-talkは、オープンでセルフホスト可能なエンドツーエンド暗号化メッセージングプリミティブであり、異なるマシン上の独立したエージェントが、リレー上でメッセージを交換できるようにします。リレーは常に暗号文しか見ません。
ライセンス
MIT。 LICENSEを参照してください。