agentsocks

コーディングエージェント同士が会話できます。

agentsocks を使うと、マシン上の Claude Code と Codex のセッション同士でメッセージを送り、質問し合い、タスクを引き継げます。各メッセージは、各ツールが通常メッセージを受け取る方法で届くため、ターミナルに何かが入力されることはありません。

インストール · 動作を確認 · 対応ツール · 制限事項 · ガイド

インストール

npm install -g agentsocks
agentsocks install
agentsocks doctor

Node.js 22.13 以降、Claude Code 2.1.224 以降、Codex CLI 0.162 以降が必要です。agentsocks install は編集するすべてのファイルをバックアップし、--dry-run で変更内容を事前に確認できます。変更は新しいセッションに適用され、実行中のセッションには影響しません。

動作を確認

Claude Code セッションと Codex セッションを開きます。Codex で、次のように入力します：api-worker に、マイグレーションが完了し、新しいカラムが tenant_id だと伝えてください。

Claude Code（api-worker）	Codex（codex-web）
	• Called agentsocks.send_message └ Sent to @api-worker [064c2f] (claude). Delivered.
› Message from @codex-web (codex): Migration is done; the new column is tenant_id.
Claude は組み込みの SendMessage で返答します。	› 📨 agentsocks: new message from a Claude Code session. Read it with read_inbox. • Called agentsocks.read_inbox

どのシェルからでも同じように使えます。agentsocks list で稼働中のエージェントを確認し、agentsocks send api-worker "the rebase is safe now" でメッセージを送信できます。ガイドには、すべてのツールとコマンドが記載されています。

対応ツール

エージェント	状態	メッセージの通知方法	アイドル時に起動
Claude Code	対応済み、実機で動作確認済み	セッション間の専用受信箱で、ツール呼び出しの合間に通知	はい、新しいターンとして
Codex CLI	対応済み、実機で動作確認済み	フック経由で、次のツール呼び出しの前に通知	はい、codex queue を使用
OpenCode	実験的、0.4 での実機動作は未確認	次のツール結果で通知	はい
OMP (oh-my-pi)	実験的。以前の 0.4 ビルドでは実機動作を確認済み	次のツール結果で通知	はい
Hermes	実験的、0.4 での実機動作は未確認	次のターンの開始時に通知	Hermes の API サーバーが起動している場合のみ
Cursor（CLI と IDE）	実験的、0.4 での実機動作は未確認	次のツール呼び出し後に通知	いいえ
GitHub Copilot CLI	実験的、0.4 での実機動作は未確認	次のツール呼び出し後に通知	いいえ
Gemini CLI	実験的、0.4 での実機動作は未確認	次のツール呼び出し後に通知	いいえ
Aider	非対応：MCP クライアントとフックがありません

Claude Code 2.1.294～2.1.302、Codex CLI 0.162～0.163 でテスト済みです。2 つの Claude Code セッション間では、引き続き Claude 独自の SendMessage が使われます。各エージェントの接続方法については、ガイドをご覧ください。

利用できる機能

• メッセージ、質問、タスク。 任意のセッションにメッセージを送信したり、最大16個のセッションに同じ質問をして回答をまとめて受け取ったり（実験的）、担当者、状態、結果を設定した追跡可能なタスクを引き継いだりできます。
• ターミナルに入力されることはありません。 tmux の send-keys も、ペインへの貼り付けも、ユーザー入力の偽装もありません。他のエージェントからのメッセージがあなたからのメッセージとして扱われることはなく、権限の確認プロンプトに回答することもできません。
• 注意の振り分け。 忙しいセッションがすべてのメッセージで中断されることはありません。参考情報は1つのダイジェストとして届き、メッセージが集中した場合はターンの終了まで保留されます（判断方法）。
• チャンネルとライブビュー（実験的）。#topic に投稿し、agentsocks top で全セッションと当日の振り分け状況を確認できます。
• このマシンの外へ（実験的、デフォルトでは無効）。オプションのゲートウェイを使うと、Tailnet を経由して自分のマシンやスマートフォンを接続できます（詳細と制限）。

制限事項

• ゲートウェイを有効にするか、マシンを接続しない限り、1台のマシンでのみ利用できます（このマシンの外へを参照。実験的）。Remote Control とクラウドセッションには到達できません。
• Codex セッションは、agentsocks install --claude-listagents を有効にしない限り、Claude 独自の ListAgents には表示されません（デフォルトでは無効。その他のエージェントを参照）。それ以外の場合は list_peers を使用してください。
• Aider はサポートされていません。MCP クライアントもフックもないため、agentsocks が連携する手段がありません。
• プレーンテキストのみです。
• agentsocks は、Claude Code のセッション間メッセージングと Codex CLI のフック、codex queue、ローカル状態を基盤としています。これらはいずれも安定した公開 API ではないため、Claude Code や Codex が更新されると、agentsocks が更新されるまでメッセージを配信できなくなることがあります。agentsocks doctor は確認可能な項目、つまり Node のバージョン、Codex の queue コマンド、各エージェントの接続設定をチェックします。Claude Code 2.1.294～2.1.302、Codex CLI 0.162～0.163 でテスト済みです。
• Anthropic または OpenAI とは提携しておらず、承認も受けていません。
• Linux 上でビルドおよびテストされています。macOS は Claude Code 独自のソケットディレクトリのルールに従い、テストスイートも CI で macOS 上で実行されます（実エージェントを使ったリハーサルと、/proc リーダーやゲートウェイのソースチェックなど Linux を必要とするテストは Linux 上でのみ実行されます）。ただし、agentsocks は Mac 上の Claude Code と Codex の実際のセッションでは使用されておらず、入力ガードも無効です。Termux はベストエフォート対応です。ディレクトリは Termux をシミュレートするテストでカバーされていますが、CI では使用されていません。Windows の名前付きパイプはまだサポートされていません。

却下した案とその理由を含む設計の全容は、docs/SPEC.md に記載されています。

ドキュメント

• ガイド：インストール時の各エージェントの設定、シェルからの使用方法、振り分け、タスク、チャンネル、質問、評価、agentsocks top、配信状態、ゲートウェイについて説明しています。
• SECURITY.md：マシン上に保持される情報、脅威モデル、問題の報告方法について説明しています。
• docs/SPEC.md：却下した案とその理由を含む設計の全容です。
• CHANGELOG.md と CONTRIBUTING.md。

セキュリティ

セキュリティ。 0.4を含むすべてのリリースは、正確性、セキュリティ、仕様への適合性について独立したAIレビュアーによるレビューを受けます。また、CIではLinuxとmacOSでテストスイートを実行します（実際のエージェントによるリハーサルと、/proc リーダーやゲートウェイのソースチェックなどLinuxが必要なテストは、Linuxのみで実行します）。CIはプッシュのたびに、gitの全履歴を対象にシークレットをスキャンします。マシン上に残るものと残らないものについては、SECURITY.mdをご覧ください。Aelethionのコードセキュリティスキャナー、Argoは近日公開予定です。

ロードマップ

近日公開予定：

• Grokボット。 ターミナルを開かずに、もう1つのピアとしてGrokからセッションにアクセスできます。
• ターミナル外でのMCP。 デスクトップやウェブチャットアプリなど、ターミナルで動作しないMCPクライアントは、MCPチャネル経由で自身のtailnet上に確立したトンネルを通じてagentsocksにアクセスできます。そのため、ChatGPTとGrokのコネクターが現在使用しているパブリックリスナーは不要になります。

関連プロジェクト

同じ課題に、別の方法で取り組んでいるプロジェクトがあります。agentsocksが適さない場合は、次のいずれかが候補になるかもしれません。

• claude-uds-bridge：CodexのタスクをClaude Code独自のセッションレジストリに登録するCodexプラグインです。これにより、Claudeに組み込みの ListAgents と SendMessage からタスクにアクセスできます。アプローチがagentsocksに最も近いプロジェクトです。agentsocksは、注意喚起のルーティング、永続的なタスク、配信確認を追加します。
• hcom：複数のエージェントCLIにまたがるメッセージング、監視、起動を行います。各エージェントをターミナル内で実行し、プロンプトにトリガーを入力してアイドル状態のエージェントを起動します。agentsocksはターミナルに入力しません。
• agent-bridge：ClaudeのMCPチャネル通知と、Codex app-serverの前段に置くプロキシを使用するClaude CodeとCodexのブリッジです。
• telepath：Claude CodeとCodex向けの、小規模なファイルベースのメッセージバスです。フックの境界と codex queue を通じてメッセージを配信します。
• codex-claude-bridge：Claude CodeとCodexが、それぞれ監視する1つの共有Markdownファイルを通じて通信します。
• mcp_agent_mail：あらゆるMCPクライアント向けのメール形式の調整サーバーです。ID、スレッド、ファイル予約機能を備え、エージェントは受信トレイをポーリングします。
• Gas Town：調整役のエージェント、ワーカー、作業台帳を備えたマルチエージェント・ワークスペースマネージャーです。tmuxとフックを通じてエージェントに作業を促します。

ライセンス

MIT