Agent 互发消息
在 Agent HUD 发行版中，Claude Code、Codex、Antigravity 与 DeepSeek Harness 通过它的 MCP 服务互相传递单条消息，从不交出整段会话。
Claude Code 写完一段改动，可以请一个 Codex 会话审一遍，Codex 的答复回到 Claude 手里；也可以新开一个会话，把任务交给它。Agent HUD 本来就看得见你 Mac 上的每个会话，所以能在原本互相够不着的客户端之间传话。传话的过程在 HUD 上看得见：每条消息都折成一只纸飞机，从发信方飞到收信方。
Agent 互发消息只在发行版中提供，免费使用，消息留在你的 Mac 上，不需要 Agent HUD Remote。从源码构建的版本有 HUD 工具，没有互发消息。
只传消息，不交出会话
一条消息里只有发信的 agent 写下的话，外加一行标签，写明它是哪个 agent、会话标题是什么。两个会话的其他内容都不会过去：之前的对话、读过的文件、调用过的工具，都留在原处。回来的也一样少：收信方的回复，或者这条消息开启的那一轮里最后的回答。
所以两个 agent 在同一个项目里工作时，项目本身就是它们共同的上下文。发信方只说要什么，比如「审一下这个分支上的改动」，收信方在自己的会话里亲自去读代码、差异和测试，谁都不用接手对方的整段对话。
哪些 agent 参与
| Agent | 发消息 | 收消息 | 可被新开 |
|---|---|---|---|
| Claude Code | ✓ | ✓ | ✓ |
| Codex | ✓ | ✓ | ✓ |
| Antigravity | ✓ | ✓ | ✓ |
| DeepSeek Harness | ✓ | ✓ | — |
Cursor 和其他 MCP 客户端可以用 HUD 工具，但不能互发消息：Agent HUD 认不出是它们的哪个会话在调用，也没有路把消息送进去。
消息只在同一台 Mac 上的主会话之间传递，不发给子 agent。收信的会话要有一条进去的路：
- Claude Code：这个会话加载了 Agent HUD 的 Claude Code 插件，并且设置 → 智能体插件里它那一行的发消息是打开的。
- DeepSeek Harness：这个会话里运行着 Agent HUD 的 DeepSeek Harness 插件，并且它那一行的发消息是打开的。Harness 会话发消息也经由同一个插件。
- Codex：有 Codex 桌面版或命令行开着这个对话。没人开着、又装了 Codex 桌面版时，Agent HUD 会在桌面版里打开它；否则消息留在 Codex 的队列里，等有人打开这个对话。
- Antigravity：经由它正在运行的本机服务送达。
打开它
在设置 → 智能体插件里，给每个要发消息的 agent 添加 HUD 工具。见接入一个 agent。
在智能体工具下打开允许 agent 互发消息。在你打开之前，它一直是关着的。
在 agent 里新开一个会话。会话在开始时加载工具，之前开着的会话没有消息工具。
然后用平常的话提要求，例如「请这个仓库的 Codex 会话审一下这段改动，等它的答复」。
一条消息怎么走
发信方发出
agent 用 list_sessions 找到收信的会话，再用 send_message 发出。调用立即返回：消息已排进队列，或者被拒收并附上原因。
等对方空闲
消息排在收信会话的队列里，等这个会话空闲后作为新的一轮送进去，不会打断正在进行的一轮。
收信方看得到是谁写的
消息第一行写明发信方和消息编号，例如 [Agent HUD · 来自 Codex · 修复登录 · m-8f2c]，最后一行说明怎样回复。
答复回来
收信方用 send_message 回复，回复等发信会话空闲后作为新的一轮送达。收信方没有 Agent HUD 的工具时，直接作答即可；发信方再用 get_message 取回答复，答复来自 Agent HUD 已经收集到的、关于那个会话的记录。取答复从不唤醒对方的会话。
agent 也可以用 start_session 新开一个 Claude Code、Codex 或 Antigravity 会话。会话落在你已经用这个客户端打开过的文件夹里，或者一个单独的任务文件夹里；装了桌面版的，就开在桌面版里。
纸飞机
- 发信方把消息折成纸飞机，飞到 HUD 上收信方的标记那里。在刘海形态下，两个 agent 分别从刘海两侧探出来；在简约与动态形态下，纸飞机从一个图标飞到另一个图标。
- 答复到达时，纸飞机飞回来一次。
- 被拒收的消息飞到一半落下。
- 同一对会话之间连发几条时，合成一只纸飞机，上面带一个数字。
- macOS 打开了「减弱动态效果」时不飞：发信方旁淡入一个封好的信封，接着收信方旁淡入一个打开的信封。
设置与防护
| 设置 | 作用 | 默认 |
|---|---|---|
| 允许 agent 互发消息 | 向接入了 HUD 工具的 agent 列出消息工具 | 关 |
| 以我的身份发送 | 消息作为你本人的话送进去，不标明来自 agent | 关 |
| 连续来回上限 | 没有你插话时，agent 之间最多连续传几次，到了就停下等你：3、5、10、20、50 或不限 | 10 |
以我的身份发送
打开以我的身份发送后，收信的 agent 会把消息当成你说的话，可以凭它替你同意删除、发布这类操作。它不知道消息来自 agent，所以会在自己的会话里直接作答，发信方用 get_message 取回答复。
- 你插一句话，计数就清零。 在这条链上任何一个会话里亲手打一句话，次数就从零开始。新开会话也算一次传递，取答复不算。
- 消息正文只在送达期间保留。 Agent HUD 记下谁给谁发了消息、正文的指纹以及答复会在哪里，这份记录保留一周。
- 不能冒充你的手机。 以
[Agent HUD · iPhone]开头的消息一律拒收，这是你从手机发出的话所带的标记。 - 正文从不截断。 不过 agent 自己的客户端在读回很长的答复时，可能会把它缩短。
消息没有送到时
| 发信方得到的说明 | 怎么办 |
|---|---|
| Agent 互发消息已关闭 | 打开允许 agent 互发消息，再新开一个会话。 |
| 这个会话没有加载 Agent HUD 的 Claude Code 插件 | 在设置 → 智能体插件里安装插件，然后在那个会话里执行一次 /reload-plugins。已关闭、或被 Claude 桌面版暂停的会话收不到消息。 |
| 这个会话里没有运行 Agent HUD 的 DeepSeek Harness 插件 | 在设置 → 智能体插件里安装插件。 |
| 消息留在 Codex 的队列里 | 没有 Codex 桌面版或命令行开着这个对话。在 Codex 里打开它。 |
| 这几个 agent 已经连续来回 N 次 | 在其中任何一个会话里打一句话，或者调高连续来回上限。 |
| Agent HUD 认不出是哪个会话在调用 | 只有 Claude Code、Codex、Antigravity 与 DeepSeek Harness 的会话能发消息。 |
最后更新于