postbag

インストール

Python 3.10 以降、Claude Code、および codex queue に対応した最近の Codex CLI が必要です。両方のセッションを、同じ postbag バージョンを使って 1 台のマシン上で実行してください。配信は macOS でテストされています。

pipx install 'postbag[mcp]'
claude mcp add --scope user postbag -- "$(command -v postbag-mcp)"
codex mcp add postbag -- "$(command -v postbag-mcp)"

各アプリで新しいセッションを開始し、/mcp を実行します。postbag に 5 つのツールが表示されるはずです。uvx などを使う場合は、MCP のセットアップをご覧ください。

または、エージェントに次のように依頼してください：llms-install.md を使って postbag をインストールしてください。

クイックスタート

bag は名前付きの会話です。両方のエージェントが同じ bag に参加します。両方が同じコードを参照できるよう、同じリポジトリで Codex と Claude Code を開きます。

1. Codex で：

   postbag の bag「review」に codex として参加してください。

2. Claude Code で：

   postbag の bag「review」に claude として参加し、codex に最後のコミットをレビューするよう依頼してください。

Claude Code が送信先を確保できるよう、先に Codex が参加します。確認を求められたら postbag のツールを承認してください。Codex は依頼を新しいターンとして受け取り、その返信も同じ方法で Claude Code に届きます。どちらからでも、返信不要を示す最終レターで終了できます。

活用例

• 相互レビュー。 Claude Code が変更を仕上げたら、コミット前に Codex に差分のレビューを依頼します。
• 分担作業。 Codex がテストを書き、Claude Code が実装を書きます。レターで互いの進捗を共有します。
• セカンドオピニオン。 一方のエージェントがバグで行き詰まったとき、もう一方に新たな視点で調べてもらいます。

ツール

エージェントがこれらを呼び出します。あなたは普通の言葉で依頼するだけです。

ツール	機能
postbag_join	このセッションを bag 内の名前で登録します。必要に応じて bag を作成します。
postbag_send	bag 内の名前宛てにレターを送信します。final: true を指定すると、返信不要になります。
postbag_read	bag の履歴をページ単位で読み込みます。
postbag_bags	ローカルの bag を、レター数と登録名とともに一覧表示します。
postbag_leave	このセッションを bag から退出させます。履歴は残ります。

仕組み

• ネイティブな配信。 受け入れられたレターは、相手のセッション自身の入力を通じて、新しいターンとして届きます。postbag は配信デーモン、ポーリング、フックを追加しません。
• セットアップ用のプロンプトは不要。 各レターには返信方法が記載されるか、返信不要であることが示されます。
• 共有履歴は 1 つ。 各 bag はローカルログを保持し、どちらのエージェントも postbag_read でページ単位に読み進められます。

送信が成功すると、送信と記録が完了したことが確認されます。受領通知もログも、受信者がレターを受け入れた、読んだ、または対応したことの証明にはなりません。

セキュリティ

• 各レターは宛先を指定し、人間がすでに許可している範囲内にとどまるよう受信者に求めます。これはモデルへのガイダンスであり、セキュリティ境界ではありません。 タスク上信頼できるセッションのみ接続してください。
• レター数に上限はありません。すべての MCP 送信を確認するには、各 postbag_send 呼び出しの前に確認を求めるようホストを設定してください。
• ~/.postbag/ 配下の台帳には、Claude Code の受信トークンが保存されています。新規ファイルにはモード 0600 が適用されます。決してコミットしたり共有したりしないでください。

SECURITY.md を参照してください。

MCP のセットアップ · コンセプト · 変更履歴 · 貢献方法 · MIT