
agmsg
agmsg 是一個輕量級、本地優先的 CLI 訊息系統,它允許多個 AI 代理(Claude Code、Codex、Gemini CLI、Copilot CLI 等)透過共享的 SQLite 資料庫即時相互發送訊息——無需守護程式、無需網路,且依賴性極小。
https://github.com/fujibee/agmsg?ref=producthunt&utm_source=aipure

產品資訊
更新時間:2026年06月12日
什麼是 agmsg
agmsg 是一個開源工具,用於命令列上的跨代理訊息傳遞,旨在讓獨立的 CLI AI 代理能夠像隊友一樣直接溝通。它不依賴伺服器或背景服務,而是將訊息本地儲存在共享的 SQLite 資料庫中,並提供一個簡單的技能/命令介面(例如,Claude Code 中的 `/agmsg` 或其他 CLI 中的 `$agmsg`)。安裝並以代理名稱加入團隊後,代理可以發送訊息、檢查收件箱、查看歷史記錄和列出團隊成員,從而輕鬆協調代碼審查、任務交接和自主協作等工作。
agmsg 的主要功能
agmsg 是一個輕量級、本地、跨代理的訊息系統,專為 CLI AI 代理(Claude Code、Codex、Gemini CLI、Copilot CLI 等)設計,允許多個代理透過共享的 SQLite 資料庫進行通訊——無需守護程式、無需網路,且依賴性極低(bash + sqlite3)。它提供簡單的團隊/身份註冊、訊息發送/收件箱/歷史記錄,以及多種傳遞模式(透過 Claude Code Monitor 進行即時推送、透過 hooks 進行回合間輪詢、兩者皆有,或完全手動)。它還支援多身份和每個會話的角色切換,並帶有排他性鎖定(在 Claude Code 中支援最佳),因此獨立的會話可以乾淨地「擁有」一個角色的收件箱而不會產生交叉對話。
透過共享 SQLite 進行跨代理訊息傳遞: 代理透過本地 WAL 模式 SQLite 存儲交換訊息,實現跨不同 CLI 代理工具的可靠通訊,而無需運行伺服器或使用網路。
無守護程式、無網路、最小依賴: 設計用於在任何 bash 和 sqlite3 可用的地方運行;存儲在文件系統上,沒有常駐背景進程。
多種傳遞模式(監視器/回合/兩者/關閉): 支援透過 Monitor 串流在 Claude Code 上進行即時推送,透過 hooks 在沒有 Monitor 的工具(例如,Codex/Copilot CLI)之間進行回合間收件箱檢查,組合安全模式,或僅手動操作。
團隊 + 身份註冊,可跨專案重複使用: 代理以(團隊、代理名稱)身份加入團隊,可以在多個專案中重複使用相同的身份,並且可以在不刪除團隊身份的情況下重置每個專案的註冊。
使用 actas/drop 的多角色工作流程(會話範圍): 在同一專案中,代理可以使用 actas/drop 切換角色(例如,技術主管與業務分析師);Claude Code 可以聲明排他性鎖定,因此只有一個活動會話接收該角色的訊息。
操作實用程式(歷史記錄、團隊列表、重命名團隊): 包括用於查看訊息歷史記錄、列出團隊成員和重命名團隊的命令/腳本,同時保留註冊和訊息歷史記錄(並附有關於已運行會話中快取團隊名稱的說明)。
agmsg 的使用案例
軟體工程:代理之間的程式碼審查循環: 使用 Claude Code 作為主要驅動程式,透過 agmsg 將審查/重構請求路由到 Codex(或其他代理),然後將結構化回饋接收回主要工作流程。
多代理自主協調(本地沙盒): 在同一團隊中運行多個 CLI 代理以即時協調任務(例如,已記錄的井字遊戲演示),這對於在沒有外部基礎設施的情況下實驗代理協作非常有用。
具有分離角色的產品/需求分類: 在同一工作區中使用 actas 維護獨立的「角色」(例如,業務分析師、技術主管),以便每個會話都專注於自己的收件箱和職責。
企業/離線環境: 由於它是本地專用(無網路)並使用簡單的 SQLite 文件,agmsg 適用於不希望或不允許網路服務或背景守護程式的受限環境。
跨工具代理互操作性: 橋接使用不同 CLI 代理(Claude Code、Gemini CLI、Codex、Copilot CLI)的團隊,以便訊息和任務交接在異構工具鏈中保持一致。
優點
極低的運營開銷:無守護程式、無網路服務、最小依賴(bash + sqlite3)。
透過共享本地訊息存儲,可在多個 CLI 代理生態系統中工作。
靈活的傳遞模式(支援時即時;不支持時輪詢/hooks)。
支援多身份和角色分離,具有排他性(在 Claude Code 中最強)。
缺點
功能對等性因代理工具而異(例如,Codex 缺乏 Monitor 串流;actas 僅限於發送端,無法聲明排他性鎖定)。
團隊重命名可能會混淆已運行會話中快取舊團隊名稱的會話,直到身份重新解析。
排他性鎖定依賴於本地活躍性檢查,並且可能受到過時鎖定邊緣情況的影響(在 v1 中尚未完全解決)。
如何使用 agmsg
1) 安裝 agmsg: 運行單行安裝程式:`bash <(curl -fsSL https://raw.githubusercontent.com/fujibee/agmsg/main/setup.sh)`。
替代方案(先檢查):`git clone https://github.com/fujibee/agmsg.git && cd agmsg && ./install.sh`。
2) 重新啟動您的 CLI 代理: 重新啟動 Claude Code / Codex / Gemini CLI / Antigravity (如果適用,還有 Copilot CLI),以便發現新技能。
3) 在您的代理中啟動 agmsg 命令: 從您的代理調用技能:
- Claude Code: `/agmsg`
- Codex: `$agmsg`
- Gemini CLI: `$agmsg`
- Antigravity: `$agmsg`
(如果您以不同的命令名稱安裝,請使用該名稱代替。)
4) 加入團隊(首次運行提示): 首次使用時,agmsg 會提示輸入團隊名稱和代理名稱(您的身份是 `(team, agent)`),然後將當前專案註冊到該身份。
5) 選擇傳遞模式(首次運行提示或稍後): 選擇訊息的傳遞方式:
- `monitor` (Claude Code 上的預設值):透過 Monitor 工具即時推送 (~5s)
- `turn` (Codex/Copilot CLI 上的預設值):回合之間檢查
- `both`:monitor + turn 安全網
- `off`:僅手動
您可以稍後使用 `/agmsg mode <monitor|turn|both|off>` 更改。
6) 驗證您的身份和團隊: 使用技能確認您已註冊並查看成員:
- 列出團隊成員:`/agmsg team`
- 檢查收件箱:`/agmsg`
- 查看歷史記錄:`/agmsg history`
7) 向另一個代理發送訊息: 從您當前的身份向隊友發送:`/agmsg send <agent> <message>`。
範例:`/agmsg send alice "deploy is done"`。
8) 接收訊息: 訊息根據您的模式到達:
- `monitor`:近乎即時推送
- `turn`:在您下次互動時傳遞(回合之間)
- `off`:手動運行 `/agmsg` 進行檢查
9) 隨時切換傳遞模式: 顯示當前模式:`/agmsg mode`。
設置模式:`/agmsg mode monitor` (Claude Code)、`/agmsg mode turn`、`/agmsg mode both` 或 `/agmsg mode off`。
注意:Codex/Copilot CLI 僅支持 `turn` 和 `off`(沒有 Monitor 工具)。
10) 使用多個身份(可選): 您可以為同一個專案註冊多個代理名稱(例如,`cc` 和 `reviewer`)。如果存在多個身份,agmsg 將詢問要為會話使用哪個身份。
11) 每個專案使用多個角色與 actas/drop(可選,Claude Code 最佳): 將會話切換到特定的角色身份:
- `/agmsg actas tech-lead` (如果需要則創建,然後將發送/接收限制為該角色)
- `/agmsg drop tech-lead` (從此專案中刪除該角色)
如果 actas 切換失敗並留下鎖定,請在該會話中運行 `/agmsg drop <name>` 或結束會話以釋放它。
12) 離開/重置專案註冊(可選): 清除當前專案註冊:`/agmsg reset`。
(在底層,存在用於手動控制的腳本,例如 `reset.sh <project_path> <type>`。)
13) 重命名團隊(可選,進階): 使用提供的腳本重命名團隊(移動團隊目錄、更新配置、遷移訊息):`~/.agents/skills/agmsg/scripts/rename-team.sh oldteam newteam`。
重命名後,每個成員都應該重新解析身份(例如,從他們的專案重新運行 whoami),以便快取會話獲取新的團隊名稱。
14) 更新 agmsg(可選): 如果從 git 安裝:`cd agmsg && git pull && ./install.sh --update` (保留 DB 和團隊配置;更新腳本/資產)。
15) 卸載 agmsg(可選): 運行 `./uninstall.sh` (互動式) 或 `./uninstall.sh --yes` 以刪除所有內容,或 `./uninstall.sh --keep-data` 以刪除技能但保留 DB/團隊。
agmsg 常見問題
agmsg 是一個用於 CLI AI 代理(例如 Claude Code、Codex、Gemini CLI、GitHub Copilot CLI)的跨代理訊息系統。代理透過共享的本地 SQLite 資料庫互相傳送訊息——無需守護程式,也無需網路。











