
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 实时推送、通过钩子在回合之间轮询、两者兼有或完全手动)。它还支持多身份和会话内角色切换,并带有排他锁(在 Claude Code 中支持最佳),因此不同的会话可以清晰地“拥有”某个角色的收件箱而不会产生交叉对话。
通过共享 SQLite 进行跨代理消息传递: 代理通过本地 WAL 模式 SQLite 存储交换消息,从而在不同的 CLI 代理工具之间实现可靠通信,而无需运行服务器或使用网络。
无守护程序、无网络、最小依赖: 设计为在任何 bash 和 sqlite3 可用的地方运行;存储在文件系统上,没有常驻后台进程。
多种传递模式(监视器/回合/两者/关闭): 支持通过 Monitor 流式传输在 Claude Code 上进行实时推送,通过钩子在回合之间进行收件箱检查以用于没有 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 代理生态系统中使用。
灵活的传递模式(支持实时;不支持时轮询/钩子)。
支持多身份和角色分离,具有排他性(在 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 工具实时推送(约 5 秒)
- `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`(保留数据库和团队配置;更新脚本/资产)。
15) 卸载 agmsg(可选): 运行 `./uninstall.sh`(交互式)或 `./uninstall.sh --yes` 以删除所有内容,或 `./uninstall.sh --keep-data` 以删除技能但保留数据库/团队。
agmsg 常见问题
agmsg 是一个用于 CLI AI 代理(例如 Claude Code、Codex、Gemini CLI、GitHub Copilot CLI)的跨代理消息系统。代理通过共享的本地 SQLite 数据库相互发送消息——无需守护程序,也无需网络。











