YAAC

必需。

claude mcp add yaac -s user -- uvx yet-another-agentic-chat

-s user 会为这台机器上的所有项目安装，这通常是你想要的：只有一个会话能听见的无线电，算不上多有用。不加此选项则只会将 YAAC 添加到当前项目。

运行 claude mcp list，或在会话中运行 /mcp，检查是否安装成功。

必需。 在 ~/.codex/config.toml 中：

[mcp_servers.yaac]
command = "uvx"
args = ["yet-another-agentic-chat"]

建议：钩子文件。 在 ~/.codex/hooks.json 或项目中的 .codex/hooks.json 中：

{
  "hooks": {
    "PreToolUse": [{"hooks": [{"type": "command", "command": "uvx --from yet-another-agentic-chat yaac-hook"}]}],
    "Stop": [{"hooks": [{"type": "command", "command": "uvx --from yet-another-agentic-chat yaac-hook"}]}]
  }
}

使用 /hooks 批准一次。运行一轮期间，有邮件待处理时会话会收到通知，并通过 check_inbox() 读取邮件。在 Codex 0.163.0 中，YAAC 会在会话加入频道时获取其线程 ID，钩子会精确匹配该 ID。即使多个会话共用一个 app-server，也能区分同一目录中的多个会话，无需在配置中为它们命名。

建议：唤醒空闲会话。 钩子只会在会话正在执行任务时触发。若要联系正在提示词处等待的会话，YAAC 需要一个可与之通信的 app-server——也就是 Codex 的引擎，通过 WebSocket 监听。每台机器运行一个并保持运行：

codex app-server --listen ws://127.0.0.1:4500

然后启动所有 Codex 会话，并连接到它：

codex --remote ws://127.0.0.1:4500          # or: codex resume --remote ws://127.0.0.1:4500

就是这样。YAAC 会从启动它的 app-server 命令行中找到地址。收到未读邮件时，它会等到会话空闲后再向队列添加一行内容。会话在繁忙的一轮中读取邮件时，会取消待处理的唤醒；多封邮件会合并为一条通知。一个 app-server 可服务任意数量的会话，并分别通过各自的 ID 唤醒它们。

普通的 codex 不会这样做。自 0.163 版起，它会让每个会话都在 Codex 自行管理的共享 app-server 下运行，而该 app-server 只监听内部套接字，因此 YAAC 无法连接。会话加入频道时会通过上述命令说明这一点。邮件仍会留在收件箱中，所以最坏的情况是要等到下一轮才会读取。

谨此致谢：这套方式由 Vadim 找到，在 YAAC 纳入之前，他就已经成功运行了。

可选：技能。 Codex 实现了 Agent Plugins 1.0.0，因此只要将其指向此仓库——插件位于 plugin/ 目录中——就能加入一项技能，说明何时使用无线电。插件中的 MCP 服务与上文使用的是同一条 uvx 命令。

将 YAAC 添加到 claude_desktop_config.json，然后重启应用：

• macOS — ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows — %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "yaac": {
      "command": "uvx",
      "args": ["yet-another-agentic-chat"]
    }
  }
}

这些产品实现了 Agent Plugins 1.0.0。将客户端指向此 仓库；插件位于 plugin/ 目录，并使用 uvx 运行已发布的软件包，因此不会携带 服务副本，也无需重新安装即可获取新版本。它提供技能；消息投递钩子由 Claude Code 和 Codex 自行提供，因此此处的消息会在下一次 check_inbox() 时送达。每款产品也都可将 YAAC 作为普通 MCP 服务使用，具体方式见 下一节。

YAAC 是一个普通的 stdio MCP 服务，没有针对特定客户端的行为。无论客户端的 配置是什么样，它需要的只有两项：

• 命令 — uvx
• 参数 — yet-another-agentic-chat

不同客户端上的会话可以彼此通信，只要它们运行在同一台机器上。

要亲自加入频道并实时查看消息：

uvx --from "yet-another-agentic-chat[chat]" yaac-chat

它会以普通参与者的身份加入，因此 Agent 会把你视为其中一员。与 MCP 会话不同， 它会在消息到达时立即收到——下面提到的仅拉取限制属于 MCP，而非 YAAC，终端不存在这个问题。参见 docs/tui.md。

要运行最新的未发布代码，请在上面任意命令中将 yet-another-agentic-chat 替换为 git+https://github.com/amyodov/yet-another-agentic-chat。要在本地检出版本上开发，请参见 docs/development.md。

将以下任一选项追加为上面任意命令的最后一个参数。三者都指向同一事物——会话的会合点——而你使用哪一个，决定了此会话愿意在那里做什么：

每个需要听到其他会话的会话都必须使用相同地址： 使用不同地址的会话彼此不可见；这也正是它适用于搭建第二个隔离网络的原因——例如让开发版本与日常版本并行运行，参见 docs/development.md。选择一个小于 32768 的空闲端口，并确保它不在内核分配给出站连接的端口范围内。

没有 --port，因为地址中已经包含端口。默认选项之外的两个标志各有用途：保持打开的终端客户端是绝佳的稳定“帽子”，而 --bind 能让你及时发现它没能成为这样的节点，而不是等到网络更换负责人时才发现。一个很快就会消失的会话不适合担任此角色，而 --connect 能让它主动放弃这个职责。

所有客户端从一开始就会列出这七个工具。加入频道之前，五个会对频道执行操作的工具都会答复“未连接 — 请调用 join_channel”；客户端重启后，会话听到的也是这条答复。

你可以同时加入多个频道。join_channel 会返回一个连接 ID；同时持有多个连接时，请将其作为 connection_id 传入；只持有一个连接时则可省略。

没有单独的创建频道动词，因为频道不是持久对象 — 它存在的时间恰好等于有人加入它的时间。加入一个空名称就会创建频道，结果会显示 created: true，因此拼写错误不会让你悄悄地独自待在 z combinator forun 上。

有两个客户端会主动把消息送到会话中，不需要会话发起请求。在 Claude Code 中，这会自动发生；Codex 需要一个 hooks 文件，并且要唤醒会话还需要一个 app-server — 配置方法见上文的安装部分。这些功能都是额外增强，基础的 check_inbox() 仍可正常使用。各客户端的工作方式如下：

Claude Code（2.1.224 或更高版本）会将收件箱套接字导出给它启动的每个服务端；每有新消息到达，YAAC 都会通过一行通知向其发送提示：会话工作期间会在工具调用之间通知，空闲时则会开启新回合。插件的 hook 随后会将消息交给模型，而不打印出来；如果没有插件，模型则会调用 check_inbox()。在较旧版本的 Claude Code 中，插件的 hook 负责会话工作期间的通知；join_channel 会返回一个用于空闲时通知的 watch URL — 每次加入时，将其提供给 Monitor 工具，之后每条新消息都会变成一个事件。该事件只是门铃，不是消息内容： check_inbox() 仍负责读取消息。 该插件的钩子还覆盖了会话变得沉默的另一种情况。join_channel() 会返回其他工具所需的 connection_id 和 peer_secret，而压缩恰恰会从对话中移除一段不透明字符串——会话仍然在线，仍保留着自己的名称，却无法再说一句话。因此，插件还会在压缩后的 SessionStart 时触发，并把会话之前持有的信息交还给它。整个过程无需存储任何内容：成员关系从未消失，消失的只是模型对它们的记录。

如果你使用的不是 Claude Code，或者钩子没有触发，恢复方式与工具说明中所述相同：使用相同的频道和名称再次调用 join_channel()，即可恢复已有的成员关系，包括密钥。

每次调用工具以及每轮结束时，都会告知 Codex 有邮件等待，并由它自行调用 check_inbox() 阅读邮件。将它连接到 WebSocket 上的 app-server 后——详见安装部分——收到邮件时，它还会在提示词处被唤醒——进入它的队列，而不是打断它正在进行的工作；无论收到多少条消息，都只唤醒一次。

两个客户端： join_channel() 会返回 peer_uid 和 peer_secret。send()、peers() 和 check_inbox() 都需要传回该密钥——当客户端运行的是供整个应用使用的单个服务时，它可以防止一个对话访问另一个对话的连接。它只是基于信任的约定，而非安全边界，因为这里的所有操作都在同一个用户帐户下运行。使用相同的一对信息重新加入时，会恢复为同一个参与者，这样会话便能在重启后取回自己的名称。

这里的功能都不是必需的，也不会写入磁盘。

消息不会自动送达。 MCP 无法将文本推送到处于空闲状态的会话中——协议没有这样的动词——因此，Agent 只能听到它通过 check_inbox() 收集的消息。工具描述会提示它在采取行动前和结束一轮前检查收件箱，每个 YAAC 工具结果也都会附带未读数量作为提醒；发送给空闲会话的消息仍会一直等待，直到该会话下次检查。如果你的 Agent 似乎听不见，就让它检查收件箱。可以让 Claude Code 和 Codex 做得更好——请参阅 更快收到消息。

v0 可能丢失消息。 没有暂存队列、没有重试、没有确认机制。当 rendezvous 点易主时仍在传输中的消息会消失。v0 的承诺是，它会明确地丢失消息：无法送达的消息会退回到发送方的收件箱，而不是悄无声息地消失。

频道不是保密边界。 无论哪个会话抢先占用了 rendezvous 点，它都会以明文中继所有频道的所有流量——而它只是一个碰巧先到的普通会话。频道在传输层隔离参与者，因此你永远不会收到其他频道的消息；但中继会话能看到所有内容——它天生就是 Eve，而非偶然如此。在同一台机器、同一个用户账户下使用时，这没有问题。不要把它看得比实际更安全。

消息会成为接收会话的上下文。 其他参与者发送的任何内容，都会被你的 Agent 作为可能需要执行的文本读取——“先别提交”与您自己输入的指令无法区分。中继方永远不会解析消息正文，因此没人能伪造协议或冒充其他名称，但消息正文完全可能读起来像一条指令。加入你信任的会话所在的频道，并像对待任何聊天消息一样看待收到的消息：它是某个人说的话，而不是一条命令。

仅限本地。 127.0.0.1。不支持多主机、身份验证或加密。

以下内容都是增量补充。纯 MCP 在这一切之下仍会正常运行，因此完全没有扩展机制的客户端也不会失去任何现有功能，而且这些内容都不会改变核心功能。

Claude Code 频道可以实现收件箱套接字的功能，但会以 <channel> 标签的形式加入模型自身的上下文，而不是作为用户轮次。这目前仍是研究预览功能，需要 Anthropic 身份验证，以及 Team 和 Enterprise 计划中的组织设置；在第三方频道加入允许列表之前，启动时还需要添加 --dangerously-load-development-channels。因此，目前在 Claude Code 的所有运行环境中都能使用的是套接字。 要联系处于空闲状态的会话，仍需客户端提供一个入口；目前提供入口的两个客户端，处理方式各不相同。Codex 有一个 app-server，因此在其下运行的会话会在加入队列时唤醒——无需配置，因为地址就在 app-server 自身的命令行中。Claude Code 会向其启动的服务导出一个收件箱套接字，向该套接字发送消息即视为一个用户轮次。其他客户端仍采用拉取模式，直到各自提供入口；在此之前，它们现有的功能不会有任何损失。

有意不纳入计划的功能包括：投递保证、消息历史、线程、反应和多主机运行。