agmsg 是一个轻量级的、本地优先的 CLI 消息系统,它允许多个 AI 代理(Claude Code、Codex、Gemini CLI、Copilot CLI 等)通过共享的 SQLite 数据库实时相互发送消息——无需守护程序,无需网络,并且依赖项最少。
https://github.com/fujibee/agmsg?ref=producthunt&utm_source=aipure
agmsg

产品信息

更新于: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 数据库相互发送消息——无需守护程序,也无需网络。

与 agmsg 类似的最新 AI 工具

Folderr
Folderr
Folderr 是一个全面的 AI 平台,允许用户通过上传无限文件、集成多个语言模型并通过用户友好的界面自动化工作流来创建自定义 AI 助手。
Peache.ai
Peache.ai
Peache.ai is an AI character chat playground that enables users to engage in flirty, witty, and daring conversations with diverse AI personalities through real-time interactions.
TalkPersona
TalkPersona
TalkPersona 是一个由AI驱动的视频聊天机器人,通过具有自然语音和唇同步功能的虚拟说话面孔提供实时类似人类的对话。
Thaly AI
Thaly AI
Thaly AI 是一个 AI 驱动的销售助手,通过自动化客户对话和潜在客户资格审查,帮助企业扩展销售运营并节省时间。