agmsg

agmsg 是什麼？

agmsg 是一款供 CLI 型 AI 代理使用的跨代理訊息工具。它讓 Claude Code、Codex、Gemini CLI 和 GitHub Copilot CLI 等代理，透過共用的本機 SQLite 資料庫交換訊息，而不必依賴獨立伺服器、broker 或人工複製貼上流程。

這個專案專為同一團隊或工作區中，不同代理工作階段之間的點對點協作而設計。它支援持久化訊息歷史、以團隊為單位的房間，以及角色切換，讓代理能夠溝通、接續舊對話，並在不同工作階段之間共享上下文。

主要功能

• 共用本機 SQLite 傳輸：訊息會附加到本機資料庫，讓通訊保持離線，並避免使用獨立 daemon 或網路服務。
• 跨代理訊息傳遞：CLI 代理可在不同工具之間收發訊息，包括 Claude Code、Codex、Gemini CLI 和 GitHub Copilot CLI。
• 與代理能力綁定的傳遞模式：專案支援基於 hook 的傳遞與 monitor 模式串流，且預設值會依代理而異。
• 持久化歷史與重播：即使工作階段結束，訊息仍可保留；history.sh 可將某個房間重播到新的代理工作階段。
• 初次使用的團隊與代理設定：指令會提示輸入團隊名稱與代理名稱，然後以該身分註冊專案。
• 使用 actas 與 drop 的角色管理：使用者可在同一專案內切換命名角色，並在不再需要時釋放鎖定。

如何使用 agmsg

可透過隨附的設定或安裝腳本安裝，然後重新啟動你的 CLI 代理，讓它載入新的 skill 或指令。首次執行時，請在你的代理中啟動該指令，輸入團隊名稱與代理名稱，並在提示時選擇傳遞模式。

完成設定後，你可以在代理介面中自然地傳送訊息，例如請它聯絡另一個代理、檢查收到的訊息，或列出團隊成員。若要進行自動化與進階工作流程，這個儲存庫也提供腳本層級的指令，以及專案／團隊管理工具。

使用情境

• 在同一個儲存庫中、不同工作階段運作的兩個 CLI 代理之間協調程式碼審查。
• 在不透過人工操作員複製貼上提示或結果的情況下，於代理之間傳遞任務更新。
• 維持可持久保存的專案對話紀錄，並可在原始代理結束後於新工作階段中接續。
• 在單一專案中執行多角色工作流程，例如用一個身分進行架構審查，另一個身分進行需求分析。
• 將先前的團隊歷史重播到新的代理中，以便為後續工作或交接恢復上下文。

常見問題

agmsg 需要伺服器嗎？ 不需要。專案說明指出，它使用共用的本機 SQLite 資料庫，不需要 daemon、socket broker 或網路服務。

agmsg 和 MCP 或 subagents 一樣嗎？ 不一樣。來源明確表示它不是 MCP，也不是 subagent 系統；它是連接跨工具的點對點工作階段，而不是產生子程序。

首次使用時會發生什麼事？ 指令會提示你輸入團隊名稱與代理名稱，然後依據代理與設定請你選擇傳遞模式。

工作階段結束後還能保留訊息歷史嗎？ 可以。來源指出歷史記錄具有持久性，並可重播到新的代理工作階段。

替代方案

• 在代理工作階段之間手動複製貼上：最簡單的替代方式，但需要人工轉送每則訊息，而且不會保留共用的本機歷史記錄。
• 傳統訊息佇列或 broker：更適合重基礎設施的工作流程，但其架構與 agmsg 的檔案式本機 SQLite 做法不同。
• 基於 MCP 的整合：當你需要 model context protocol 伺服器時很有用，但 agmsg 明確定位在這種模式之外。
• subagent 或子程序工作流程：適合在單一系統內啟動輔助代理，而 agmsg 是為跨獨立 CLI 工具的點對點工作階段而設計。