マニュアル

各機能の使い方リファレンス。新機能追加のたびに更新します。

agmsg — Claude Code × Codex AI エージェント連携

インストール済み · 最終更新 2026-06-03

概要

agmsg（GitHub）は、 CLI AIエージェント同士がローカルの共有SQLiteを介してメッセージをやり取りするOSSです。 Claude Code で実装を進めながら、難しい箇所だけ Codex にレビューを投げるという 2台体制の開発をコピペなしで実現します。

この環境での状態： インストール済み（sqlite3 は ~/bin/sqlite3.exe に配置済み）。 初回のみ /agmsg でチーム参加が必要です。

仕組み

Claude Code ─── messages.db ─── Codex
            ↑ 共有 SQLite（WAL モード）↑
            ~/.agents/skills/agmsg/db/
  • デーモン・ネットワーク不要。bash と sqlite3 だけで動作。
  • 同一 PC 上のエージェント間のみ通信可能（ローカル限定）。
  • Claude Code は monitor モード（〜5秒でリアルタイム受信）、Codex は turn モード（応答のたびに受信確認）。

初回セットアップ

  1. 1

    Claude Code のターミナルで実行

    /agmsg

    初回のみ、チーム名・エージェント名・配信モードを聞かれます。

  2. 2

    聞かれる項目

    項目 入力例 備考
    チーム名 myteam Codex 側と同じ名前
    エージェント名 claude このウィンドウの識別名
    配信モード 1（monitor） 推奨。リアルタイム受信
  3. 3

    Codex 側でも同じチームに参加

    $agmsg

    同じチーム名・別のエージェント名（例: codex）で参加します。Codex は turn モードのみ対応。

日常的な使い方（Claude Code）

コマンド 動作
/agmsg 受信メッセージを確認
/agmsg send codex レビューして Codex にメッセージ送信
/agmsg team チームメンバー一覧
/agmsg history 会話履歴を表示
/agmsg mode monitor リアルタイム受信に切り替え

自然言語でも OK：「codex にこのコードのレビューを依頼して」と話しかけるだけで送信してくれます。

配信モード一覧

monitor（推奨）

SQLite を 5 秒おきにポーリング。メッセージが来たら即座に会話に割り込む。SessionStart フックで自動起動。

turn

各応答の終了後（Stop フック）に受信確認。Codex はこのモードのみ対応。

both

monitor を主に、turn を保険として両方動かす。確実に届けたい場面向け。

off

/agmsg を手動実行したときだけ受信確認。自動配信なし。

典型的なワークフロー例

① Claude Code でガリガリ実装を進める

② 難しい設計判断や「このアプローチで合ってる？」という箇所が出たら：

/agmsg send codex この実装どう思う？[コードを貼る]

③ Codex がレビューを返す（monitor モードなら〜5秒で Claude Code に通知）

④ Claude Code で指摘を受け取り、そのまま修正を続ける

⑤ 「codex にこのファイルを確認してもらって」と Claude Code に話しかければ代わりに送信してくれる

Windows 環境での注意点

  • sqlite3 は ~/bin/sqlite3.exe に手動配置済み。Git Bash は ~/bin をデフォルト PATH に含むため、新ターミナルでも即使用可。
  • WSL や PowerShell からは sqlite3 が見えない（Git Bash 専用）。
  • agmsg のスクリプト群は Git Bash で動作。PowerShell からの実行は不可。
  • 通信はローカルの SQLite ファイルのみ。他 PC との通信は非公式（AGMSG_STORAGE_PATH を共有ドライブへ）。

インストール済みファイル一覧

~/.agents/skills/agmsg/ ← スキル本体

~/.agents/skills/agmsg/db/messages.db ← SQLite メッセージDB

~/.claude/commands/agmsg.md ← /agmsg スラッシュコマンド

~/.codex/config.toml ← Codex 書き込み権限設定済み

~/bin/sqlite3.exe ← sqlite3 バイナリ（Git Bash PATH）

更新 / アンインストール

アップデート

git clone https://github.com/fujibee/agmsg.git && cd agmsg && ./install.sh --update

DB・チーム設定は保持されます。

アンインストール

./uninstall.sh --keep-data # データ保持
./uninstall.sh --yes # 完全削除