agmsg

什么是 agmsg？

agmsg 是一款面向 CLI 的 AI agent 的跨 agent 消息工具。它让 Claude Code、Codex、Gemini CLI 和 GitHub Copilot CLI 等 agent 通过共享的本地 SQLite 数据库交换消息，而不是依赖单独的服务器、broker 或人工复制粘贴流程。

该项目面向同一团队或工作区内不同 agent 会话之间的点对点协作而设计。它支持持久化消息历史、基于团队的房间以及角色切换，方便 agent 进行通信、恢复旧对话，并在会话之间共享上下文。

主要功能

• 共享本地 SQLite 传输：消息会追加到本地数据库中，通信保持离线，且无需单独的 daemon 或网络服务。
• 跨 agent 消息传递：CLI agent 可以在不同工具之间收发消息，包括 Claude Code、Codex、Gemini CLI 和 GitHub Copilot CLI。
• 与 agent 能力绑定的投递模式：项目支持基于 hook 的投递和 monitor 模式流式传输，默认值会因 agent 而异。
• 持久历史与重放：消息在会话结束后仍然可用，history.sh 可以将某个房间重放到新的 agent 会话中。
• 首次使用时进行团队与 agent 设置：命令会提示输入团队名称和 agent 名称，然后为该身份注册项目。
• 使用 actas 和 drop 进行角色管理：用户可以在同一项目内切换不同命名角色，并在不再需要时释放锁。

如何使用 agmsg

使用提供的安装或 setup 脚本进行安装，然后重启你的 CLI agent，以便它加载新的技能或命令。首次运行时，在 agent 中启动该命令，输入团队名称和 agent 名称，并在提示时选择投递模式。

完成设置后，你可以在 agent 界面中自然地发消息，例如让它给另一个 agent 发消息、检查传入消息，或列出团队成员。对于自动化和高级工作流，仓库还提供了脚本级命令以及项目/团队管理工具。

使用场景

• 在同一仓库但不同会话中的两个 CLI agent 之间协调代码审查。
• 在不通过人工转述提示词或结果的情况下，在 agent 之间传递任务更新。
• 维护一份可持续的项目对话日志，在原始 agent 退出后仍可在新会话中恢复。
• 在一个项目中运行多角色工作流，例如用一个身份做架构审查，另一个身份做需求分析。
• 将之前的团队历史重放到新 agent 中，以便恢复上下文并继续后续工作或交接。

常见问题

agmsg 需要服务器吗？
不需要。项目说明称它使用共享的本地 SQLite 数据库，不需要 daemon、socket broker 或网络服务。

agmsg 和 MCP 或 subagents 一样吗？
不一样。源文明确说明它不是 MCP，也不是 subagent 系统；它连接的是跨工具的并行会话，而不是生成子进程。

首次使用时会发生什么？
命令会提示你输入团队名称和 agent 名称，然后根据 agent 和设置让你选择投递模式。

会话结束后还能保留消息历史吗？
可以。源文说明历史是持久的，并且可以重放到新的 agent 会话中。

替代方案

• 在 agent 会话之间手动复制粘贴：最简单的替代方案，但需要人工转发每条消息，且不会保留共享的本地历史。
• 传统消息队列或 broker：更适合基础设施较重的工作流，但其架构与 agmsg 的文件支持本地 SQLite 方式不同。
• 基于 MCP 的集成：当你需要 model context protocol 服务器时很有用，但 agmsg 明确将自己定位在这种模式之外。
• subagent 或子进程工作流：适合在同一系统内启动辅助 agent，而 agmsg 面向的是跨独立 CLI 工具的并行会话。