agmsg 对等 CLI 代理协调器

解决什么问题

同时开着 Claude Code、Codex、Gemini CLI 或 Copilot CLI 时，每个代理都活在自己的终端会话里。想让一个代理把结果交给另一个代理，通常只能复制粘贴上下文、写中间文件，或者手工复述意图。消息传到下一环时往往已经失真，也让「谁负责收尾」变得模糊。

agmsg 技能要解决的是：让多个终端代理共享一个本地消息通道，在不引入服务端、不复制上下文的前提下完成对等协调。

技能如何工作

这个技能的核心是 agmsg：一个轻量级传输层，背后只有一个共享的本地 SQLite 文件。

• 共享 SQLite 作为总线：消息持久化在本地数据库里，发送方写入，接收方读取。没有额外基础设施。
• 钩子与投递模式：每个代理挂一个钩子，或根据投递模式接入 Monitor 流，从共享 SQLite 中读取并把文本呈现给代理，让它决定如何反应。
• 安装与先决条件：需要 bash、sqlite3 和 agmsg 脚本，并按需搭配 Claude Code、Codex、Gemini CLI、Copilot CLI、Antigravity 或 OpenCode 使用。首次使用斜杠命令时按提示输入团队名称和代理名称，再选择投递模式；例如 Claude Code 中默认 monitor 为实时推送。
• 发送消息：发送方向队列写入，交由接收侧按各自节奏消费，不做阻塞式等待。

适用边界与注意点

• 这不是通用消息中间件，而是面向本地终端代理的轻量级传输层，主要适合单机内的多代理编排。
• macOS 自带 bash 与 sqlite3；在精简 Linux 或部分 Debian/Ubuntu 容器、Alpine 上，可能需要先准备 sqlite3。
• 沙盒白名单仍然必要：执行 agmsg 写入操作时，仍需允许其写入对应路径。
• 单次运行场景下，特定运行的可写根目录也必须覆盖 SQLite 通道所在位置。
• 需要跨团队名称、代理名称、投递模式和运行环境确认安装路径一致；消息是异步传递，消费节奏依赖接收代理。

适用场景与边界

agmsg 适合让多个终端代理通过共享本地 SQLite 通道交换消息，解决跨工具协作时缺少统一传输层的问题。

• 每个代理通过钩子或 Monitor 流读取共享 SQLite，把传入文本呈现给模型并作出反应。
• 发送方使用 agmsg 写入消息，接收方异步消费，不阻塞发送侧。
• 常见用法包括跨代理交接结果、触发后续任务，以及让多个 CLI 代理在同一工作区交换短消息。

限制与注意事项

• 它依赖 bash 和 sqlite3；macOS 通常已自带，精简 Linux 或容器可能需要先安装 sqlite3。
• 沙盒白名单仍必须覆盖 agmsg 的写入操作；单次运行时，可写根目录也应包含 SQLite 通道。
• 消息按投递模式异步传递，没有资料中描述的事务性保证或重试机制。
• 各代理的团队名称、代理名称、投递模式和运行环境需要对齐，否则可能读到不属于自己的消息或无法消费。