agmsg

agmsgとは？

agmsg は、CLI ベースの AI エージェント向けのクロスエージェントメッセージングツールです。Claude Code、Codex、Gemini CLI、GitHub Copilot CLI などのエージェントが、別のサーバー、broker、または人手によるコピペのワークフローに頼らず、共有のローカル SQLite データベースを通じてメッセージをやり取りできます。

このプロジェクトは、同じチームまたはワークスペース内の異なるエージェントセッション間でのピアツーピア連携を想定しています。永続的なメッセージ履歴、チームベースのルーム、ロール切り替えに対応しており、エージェント同士が会話を続けたり、過去のやり取りを再開したり、セッションをまたいでコンテキストを共有したりできます。

主な機能

• 共有ローカル SQLite 転送: メッセージはローカルデータベースに追記され、通信をオフラインで保ち、別の daemon やネットワークサービスを不要にします。
• クロスエージェントメッセージング: CLI エージェントは、Claude Code、Codex、Gemini CLI、GitHub Copilot CLI を含む異なるツール間で送受信できます。
• エージェントの機能に応じた配信モード: hook ベースの配信と monitor-mode ストリーミングをサポートし、デフォルトはエージェントごとに異なります。
• 永続的な履歴と再生: メッセージはセッション終了後も利用でき、history.sh で room を新しいエージェントセッションに再生できます。
• 初回利用時のチームとエージェントの設定: コマンドが team 名と agent 名を求め、その ID でプロジェクトを登録します。
• actas と drop によるロール管理: 同じプロジェクト内で名前付きロールを切り替えられ、不要になったロールのロックを解放できます。

agmsg の使い方

提供されているセットアップまたはインストールスクリプトでインストールし、その後 CLI エージェントを再起動して、新しい skill または command を読み込ませます。初回実行時は、エージェント内でコマンドを起動し、team 名と agent 名を入力し、必要なら配信モードを選択します。

セットアップ後は、エージェントのインターフェースで自然にメッセージを送れます。たとえば、別のエージェントにメッセージを送る、受信メッセージを確認する、チームの参加者を一覧表示する、といった操作ができます。自動化や高度なワークフロー向けに、リポジトリにはスクリプトレベルのコマンドやプロジェクト/チーム管理ユーティリティも用意されています。

ユースケース

• 同じリポジトリで別セッションを使って作業している 2 つの CLI エージェント間でコードレビューを調整する。
• 人間の操作でプロンプトや結果をコピペせずに、エージェント間でタスク更新を渡す。
• 元のエージェント終了後も新しいセッションで再開できる、永続的なプロジェクト会話ログを保持する。
• 1 つのプロジェクトで複数ロールのワークフローを実行し、たとえば 1 つの ID をアーキテクチャレビュー、別の ID を要件分析に使う。
• 以前のチーム履歴を新しいエージェントに再生して、フォローアップ作業や引き継ぎのためにコンテキストを復元する。

FAQ

agmsg に server は必要ですか？ いいえ。プロジェクト説明では、共有のローカル SQLite データベースを使い、daemon、socket broker、ネットワークサービスは不要とされています。

agmsg は MCP や subagent と同じですか？ いいえ。ソースでは、MCP でも subagent システムでもないと明示しており、子プロセスを起動するのではなく、ツール間の peer セッションを接続します。

初回利用時はどうなりますか？ コマンドが team 名と agent 名を求め、その後、エージェントとセットアップに応じた配信モードを選ぶよう促します。

セッション終了後もメッセージ履歴は保持できますか？ はい。ソースでは、履歴は永続的で、新しいエージェントセッションへ再生できるとされています。

代替手段

• エージェントセッション間での手動コピペ: 最も簡単な代替手段ですが、すべてのメッセージを人が中継する必要があり、共有のローカル履歴は残りません。
• 従来型のメッセージキューや broker: インフラ重視のワークフローにはより適していますが、agmsg のファイルベースのローカル SQLite 方式とは異なる構成です。
• MCP ベースの統合: model context protocol server が必要な場合には有用ですが、agmsg はそのパターンの外側に位置づけられています。
• subagent や子プロセスのワークフロー: 1 つのシステム内で補助エージェントを起動する用途に適していますが、agmsg は別々の CLI ツール間の peer セッション向けに設計されています。