agent-intercom

---

はじめる

npx agent-intercom install

Claude Code だけを使っていますか？代わりにプラグインとしてインストールできます：

/plugin install agent-intercom --marketplace iambashar/agent-intercom

_{2.1.275 より古い Claude Code の場合：/plugin marketplace add iambashar/agent-intercom を実行し、続けて /plugin install agent-intercom@agent-intercom を実行します。このプラグインは、メールボックスの規約を Claude に教えるスキルも追加します。}

npx コマンドは、見つかったすべての CLI に MCP サーバーを登録します。各 CLI を再起動すると、それぞれのエージェントで 3 つのツール（mail_send、mail_check、mail_peers）が使えるようになります。あとは、自然な言葉で依頼してください：

あなた → Claude： Codex に src/parser.ts の差分をレビューするよう頼み、回答を待ってください。

誰もポーリングしなくて済むよう、ライブプッシュを有効にしましょう。デーモンが安定したパスを必要とするため、グローバルにインストールしてください：

npm i -g agent-intercom
agent-intercom install --push

install による CLI ごとの変更内容

CLI	登録方法	プッシュ用の追加設定
Claude Code	claude mcp add、ユーザースコープ	なし。Claude Code のピアソケットを使用
Codex CLI	~/.codex/config.toml に管理ブロックを追加（事前にバックアップ）	なし。Codex app-server デーモンを使用
Antigravity (agy)	agy mcp add	~/.gemini/config/hooks.json にセッションフックを追加

1 つの CLI のみを対象にするには --only claude|codex|gemini を、npx の代わりに git チェックアウトを固定するには --local を使用してください。agent-intercom uninstall は、プッシュデーモンを含むすべての設定を削除します。

メモ

古い gemini CLI は、個人用の Google AI Pro アカウントでのサインインを受け付けなくなりました。Google は該当ユーザーを Antigravity CLI（agy）に移行しました。ここでは、そのエージェントの名前はデフォルトで gemini です。

動作を見る

どちらのエージェントもポーリングしません。リクエストを送信するとすぐに、Codexに新しいターンとして表示され、返信も同じようにClaudeに届きます。

利用できる機能

対応エージェント

エージェント	メールボックス名	メッセージが開いているセッションに届く方法
	claude	Claude Codeのローカルなピアメッセージングソケットを使います。これはセッション間でSendMessageが使用するチャネルです。別のセッションからのメッセージとしてラベル付きで届きます。
	codex	Codex TUIが実行される共有アプリサーバーデーモンを使います。turn/start、またはターンがすでに実行中の場合はturn/steerを使用します。
	gemini	agy agentapi send-messageで会話に送信します。各セッションはフックを通じて一度だけ登録します。
その他のMCPクライアント	任意	プッシュはありません。mail_checkで読み取るか、mail_check(wait_seconds=300)で到着を待ちます。

ツール	説明
mail_send(to, body, reply_to?)	別のエージェントの受信トレイにメッセージを送信します
mail_check(wait_seconds?)	メッセージを読み取って取得します。wait_seconds（最大300）を指定すると、メッセージが届くまで待機します
mail_peers()	認識済みのエージェントを一覧表示します

プッシュの仕組み

sequenceDiagram
    autonumber
    participant C as Claude Code
    participant M as ~/.agent-mail/codex/inbox
    participant P as pushd
    participant X as Codex CLI (open session)
    C->>M: mail_send(to: "codex", body)
    M-->>P: file appears (fs.watch, no polling)
    P->>M: claim: rename to <id>.json.pushing
    P->>X: turn/start with the message
    X-->>P: turn accepted
    P->>M: move to read/
    Note over X: Codex works on it, then replies with mail_send(to: "claude")

• 一度だけ配信されます。 デーモンはプッシュする前にメッセージの名前を変更し、mail_check は読み取る前に名前を変更します。先に名前を変更した側が配信します。

• 安全側に倒れます。 プッシュに失敗すると、ファイルは受信トレイに戻され、30秒後に再試行されます。開いているセッションがない場合、メッセージは mail_check を待ちます。

• 宛先の指定。 claude.<session-name>、codex.<thread-id-prefix>、または gemini.<conversation-prefix> でセッションを選択します。指定がない場合は、最も最近アクティブだったセッション、または ~/.agent-mail/routes.json で指定されたセッションに配信されます。

  { "claude": "api-server", "codex": "019f018a" }
  

警告

プッシュは3つすべてのCLIの文書化されていない内部仕様に依存しており、アップデートによって予告なく変更される場合があります。その場合、プッシュは失敗してログに記録され、メールは受信トレイに戻されます。プロトコルの詳細：docs/live-push.md。

プッシュデーモンを使わない場合

• Claude Code： docs/claude-monitor.md。Monitor ツールで agent-intercom watch claude を実行すると、メールが届いたときにセッションが起動します。
• Codex： docs/codex-listen.md。mail_check(wait_seconds=300) を繰り返し実行するリスナープロンプトです。

マシン間の連携

GPU サーバーや HPC クラスターなど、共有ファイルシステムのないマシン上のエージェントは、bridge.sh を使って SSH 経由で参加できます。各メッセージは宛先が動作しているマシンに移動され、取得されたメールはほかのメールと同じようにプッシュされます。

BRIDGE_HOST=gpu-box REMOTE_AGENTS="claude-gpu" ./bridge.sh

flowchart LR
    subgraph laptop["💻 Laptop"]
        A[claude] & B[codex] & G[gemini]
    end
    subgraph gpu["🖥️ gpu-box"]
        R[claude-gpu]
    end
    laptop <-- "bridge.sh · rsync over SSH" --> gpu

詳細：docs/remote-bridge.md。

CLI ごとに複数のセッションを使う

名前は AGENT_NAME にすぎません。たとえば claude-api と claude-web のように、各セッションに個別の名前を付けます。

npx agent-intercom install --only claude --claude-name claude-api

CLI

agent-intercom install [--only claude|codex|gemini] [--claude-name N] [--codex-name N] [--gemini-name N] [--local] [--push]
agent-intercom uninstall        MCP entries, agy hook and push daemon
agent-intercom push install     push daemon as a login service (launchd / systemd --user)
agent-intercom push uninstall
agent-intercom push run         push daemon in the foreground
agent-intercom status           unread/read counts per agent
agent-intercom watch <name>     one line per new message, without consuming it
agent-intercom serve            the MCP server on stdio

セキュリティ

これは認証機能のないローカルメールボックスです。あなたのユーザーとして実行されるプロセスであれば、どれでも ~/.agent-mail/*/inbox に書き込めます。また、エージェントはメッセージを実行すべき入力として扱います。プッシュを有効にすると、何も入力しなくても、その入力が開いているセッションに届きます。

• 受信トレイの内容は信頼できないテキストとして扱ってください。メッセージに指示されたという理由で、あるエージェントに破壊的な操作を承認させないでください。
• プッシュされたメッセージには [agent-intercom] message <id> from <sender> というラベルが付きます。Claude Code では、あなたからではなく、別のセッションからのメッセージであることも示されます。
• プッシュは、あなたのユーザーだけが読み取れるトークン（~/.claude/sessions/*.key、agy セッショントークン）のみを読み取り、ローカルソケットとのみ通信します。マシン外にデータが送られることはありません。

問題の報告については SECURITY.md をご覧ください。AGENT_MAIL_DIR を設定すると、メールボックスを移動できます。たとえば、プロジェクトフォルダー内に配置できます。

🤝 貢献

誤字の修正から新しいエージェントのサポートまで、あらゆる貢献を歓迎します。

やりたいこと	こちらから始めましょう
小さな修正をする	初めての方におすすめの課題
別のコーディングエージェントをサポートする	docs/adding-an-agent.md
CLI の更新後にプッシュが機能しなくなったことを報告する	バグ報告
質問する、またはアイデアを提案する	ディスカッション

プルリクエストを作成する前に、CONTRIBUTING.md をお読みください。ここに参加する皆さんは、行動規範を遵守します。

開発

git clone https://github.com/iambashar/agent-intercom && cd agent-intercom
npm test                          # node --test, no dependencies
python3 scripts/build-assets.py   # rebuild the README artwork

実行時の依存関係はありません。Node 20 以降が必要です。CONTRIBUTING.md と変更履歴をご覧ください。