连接 Codex Desktop 与 WorkBuddy

准备

1. 在同一台电脑安装 Beav 桌面版或 CLI 版。
2. 确认 beav version 能运行；测试压缩包也可以使用其中的 bin/beav 完整路径。
3. 打开 Codex Desktop，在任意任务中发送下面的提示词。

/goal Read https://beav.ziz.hk/agent to install the Beav Creator plugin and set up a new task for me.

Codex 会执行什么

1. 读取 /agent 返回的机器安装指南。
2. 定位 Codex Desktop 自己内置的 CLI，不依赖用户终端的 PATH。
3. 执行 beav extension prepare codex --output json，取得 marketplacePath 与 pluginId。
4. 通过 Codex CLI 添加 beav-local marketplace 并安装 beav-creator@beav-local。
5. 再次读取插件列表，确认插件已经安装并启用。
6. 创建一个新任务，让新加载的 Beav Creator MCP 在新会话中生效。

beav extension install codex --output json 是兼容别名，同样只准备插件，不会自行调用裸 codex 命令或修改 Codex 配置。

新任务如何协作

新任务先调用 creator_status 与 workspace_list，然后用 typed MCP 工具把 Task Brief 委派给 Beav 内部 Agent。需要用户查看、审批或细调时，Beav 返回 localhost browser handoff；浏览器只是用户工作台，不是 Agent 控制面。

后续修改继续查询并续接同一个 Beav task。只有任务进入协议终态、要求的产物可读回时，Codex 才能声明任务完成。

机器可执行安装契约位于 https://beav.ziz.hk/agent.md。

WorkBuddy 接入

把下面的提示词发送给 WorkBuddy：

Read https://beav.ziz.hk/workbuddy to install the Beav Creator plugin and connect it to my local Beav workspace.

WorkBuddy 会执行：

1. 读取 /workbuddy 返回的机器安装指南。
2. 定位 WorkBuddy App 内置的 CodeBuddy CLI，不要求 shell PATH 已配置 codebuddy。
3. 执行 beav extension prepare workbuddy --output json，生成 .codebuddy-plugin marketplace。
4. 使用 codebuddy plugin validate 校验 marketplace，再以 user scope 安装 beav-creator@beav-local。
5. 通过 /reload-plugins 热加载插件，并用 creator_status 与 workspace_list 验证同一套 Beav MCP。

beav extension install workbuddy --output json 是 prepare-only 兼容别名。Codex 与 WorkBuddy 只在宿主安装格式和加载方式上不同；两者共享同一个 Beav Creator Skill、Creator Gateway、内部 Agent 和 localhost 用户工作台。

机器可执行安装契约位于 https://beav.ziz.hk/workbuddy.md。