agmsg コマンド早見表（自分用メモ）
agmsg の操作を、英語 README を毎回読み返さずに済むよう日本語でまとめた早見表です。agmsg がどういうツールか・なぜ使い始めたかは codex-plugin-cc から agmsg に乗り換えました に書いたので、ここではコマンドだけ並べます。
以下はコマンド名がデフォルトの agmsg 前提です。インストール時に別名を付けた場合は /agmsg → /<その名前>、スクリプトのパスも ~/.agents/skills/<その名前>/ に読み替えてください。
基本概念
- エージェントは
(agent名, team名)の組で識別される。同じ team の者同士がメッセージできる - team はプロジェクト横断。プロジェクトは登録メタデータとして保存されるだけで、同じ identity で別リポジトリから join しても重複しない
- 配信モードはプロジェクト単位で、
<project>/.claude/settings.local.jsonの hook として書かれる - agent の種別（type）は
claude-code/codex/geminiのいずれか。join 系コマンドの引数で使う
インストール / 更新 / アンインストール
# インストール（一行）bash <(curl -fsSL https://raw.githubusercontent.com/fujibee/agmsg/main/setup.sh)
# または clone してからgit clone https://github.com/fujibee/agmsg.git && cd agmsg && ./install.sh./install.sh --cmd m # コマンド名を非対話で指定（例: m）
# 更新（DB と team config は保持。scripts と assets のみ更新）cd agmsg && git pull && ./install.sh --update
# アンインストール./uninstall.sh # 対話（各ステップ確認）./uninstall.sh --yes # 全部消す./uninstall.sh --keep-data # skill だけ消して DB / team は残すインストール / 更新後はエージェント（Claude Code / Codex）を再起動して skill を読ませます。
エージェントへの話しかけ方（通常運用）
セットアップ後は基本これだけ。
- 「sam にこの差分のレビュー投げて」
- 「メッセージ来てる?」
- 「team に誰いる?」
スラッシュコマンド（Claude Code）
/agmsg # 受信箱を確認（全 team）/agmsg history # メッセージ履歴/agmsg team # メンバー一覧/agmsg send <相手> <メッセージ> # 送信/agmsg mode <monitor|turn|both|off> # 配信モード切替/agmsg mode # 現在のモード表示/agmsg actas <名前> # このプロジェクト内で別の役割に切替（未登録なら作成）/agmsg drop <名前> # このプロジェクトから役割を外す/agmsg reset # 現プロジェクトの登録をクリア/agmsg hook on | off # 旧コマンド（= mode turn | off）。非推奨Codex は $agmsg（または /skills → agmsg）。Codex は mode turn と mode off のみで、monitor / both は Monitor tool を持つ Claude Code 専用です。
join / leave / チーム操作
# 手動 join: join.sh <team> <agent名> <type> <project>~/.agents/skills/agmsg/scripts/join.sh myteam alice claude-code "$(pwd)"
# 離脱~/.agents/skills/agmsg/scripts/leave.sh myteam alice
# team 名を変更（ディレクトリ移動 + config.json 更新 + メッセージ移行）~/.agents/skills/agmsg/scripts/rename-team.sh oldteam newteam
# identity を再解決（rename 後などに各メンバーが実行して新名を拾う）~/.agents/skills/agmsg/scripts/whoami.sh "$(pwd)" claude-code対話で入れる場合は、プロジェクトを開いて /agmsg（Codex は $agmsg）を実行 → team 未参加を検知して team 名・agent 名を聞かれる、の流れでもOKです。
同じ team に別名で足す（複数 identity）
同じプロジェクト・同じ CLI から、agent 名を変えれば別の参加者として共存できます。2個目の Codex を codex-reviewer として入れる例:
~/.agents/skills/agmsg/scripts/join.sh dev codex-reviewer codex "$(pwd)"引数は join.sh <team> <agent名> <type> <project>。
- 第2引数
codex-reviewer… team 内での別名（既存メンバーと重複しなければOK、ハイフン可） - 第3引数
codex… agent の種別。ここは別名にしない（Claude Code ならclaude-code）
複数 identity が登録されていると、コマンド実行時に「どの identity を使うか」セッションごとに聞かれます。逆に既存と同じ team・同じ agent 名で join し直しても、identity は同一のまま登録レコードが足されるだけで、別人にはなりません。「増やしたい」なら名前を変える、が要点です。
README の複数 identity の例は type が
claude-codeですが、join.shの第3引数は汎用の<type>なので、Codex ならcodexを入れれば同じ要領で足せます。
配信モード
| モード | 仕組み | レイテンシ | 対象 |
|---|---|---|---|
monitor（CC デフォルト） | SessionStart hook → Monitor tool で SQLite を blocking stream | 約5秒（リアルタイム push） | Claude Code |
turn（Codex デフォルト） | Stop hook が応答ごとに check-inbox.sh を実行 | 次のやり取りまで | Codex / 静かに回したい CC |
both | monitor 主 + turn をセッション内の安全網 | 約5秒（失敗時 turn 末で回収） | 取りこぼしたくない時 |
off | 自動受信なし | 手動 /agmsg のみ | 最小構成 |
/agmsg mode monitor # リアルタイム push（CC）/agmsg mode turn # 応答ごとに inbox チェック/agmsg mode both # monitor + turn フォールバック/agmsg mode off # 手動のみ/agmsg mode # 現在のモード表示設定はプロジェクト単位で、<project>/.claude/settings.local.json に必要な hook だけが書かれます。set は冪等なので同じモードを叩き直しても hook は重複しません。あとからいつでも切り替え可能です。
シェルスクリプト直叩き（どのエージェントでも）
/agmsg を介さず素のスクリプトで操作したいとき用。パスは ~/.agents/skills/agmsg/scripts/。
send.sh <team> <from> <to> "<message>" # 送信inbox.sh <team> <agent_id> # 受信箱history.sh <team> [agent_id] [limit] # 履歴team.sh <team> # メンバー一覧whoami.sh <project_path> <type> # identity 確認delivery.sh set <mode> <type> <project_path> # 配信モード設定delivery.sh status [<type> <project_path>] # 配信モード確認reset.sh <project_path> <type> [agent_id] # 現プロジェクトの登録クリア