WorkBuddy 使用指南

本教程介绍如何通过 WorkBuddy 控制 ego (lite)：开启 Full Access，在桌面端或 CodeBuddy Code TUI 中加载 ego-browser，并完成一次浏览器任务。

WorkBuddy 可以通过桌面端或 Terminal 中的 CodeBuddy Code 控制 ego (lite)。本指南以 Anthropic 的 X 主页为例，由 WorkBuddy 在 ego (lite) 的 Agent Space 中打开页面，读取前五条帖子，并将结果返回到对话中。

上方是桌面端的完整操作过程。Terminal 使用相同的 ego-browser Skill 和任务指令。

开始前：安装 ego (lite)

打开 WorkBuddy 前，请先安装 ego (lite) 并完成初始设置。

下载并打开 DMG 安装包
按照指示，双击 ego (lite) 的 icon 进行安装
启动 ego (lite)，完成初始设置
在 WorkBuddy 桌面端选择工作区，或者先在 Terminal 中进入项目目录，再启动 CodeBuddy Code

ego (lite) 会将 ego-browser 安装到 ~/.agents/skills/。WorkBuddy 和 CodeBuddy Code 从 ~/.codebuddy/skills/ 读取用户级 Skill。如果列表中没有 /ego-browser，请运行以下命令，将已安装的 Skill 同步到 WorkBuddy 的目录：

mkdir -p ~/.codebuddy/skills/ego-browser
cp -R ~/.agents/skills/ego-browser/. ~/.codebuddy/skills/ego-browser/

复制完成后，请重新启动 WorkBuddy。

选择 WorkBuddy 桌面端或 Terminal

使用桌面端时，先选择工作区并新建任务。使用 Terminal 时，进入项目目录，然后通过以下命令启动 CodeBuddy Code 并开启 Bypass permissions：

codebuddy --dangerously-skip-permissions

如果没有单独安装 CodeBuddy Code，可以直接运行 WorkBuddy macOS 应用内置的 CLI：

"/Applications/WorkBuddy AI.app/Contents/Resources/app.asar.unpacked/cli/bin/codebuddy" \
  --dangerously-skip-permissions

TUI 启动后，底部状态栏会显示 bypass permissions on。此时，WorkBuddy 桌面端和 CodeBuddy Code 都可以通过 /ego-browser 调用 Skill。

第 1 步：开启 Full Access

桌面端

在 WorkBuddy 桌面端打开任务输入框下方的权限菜单，将 Default Permission 切换为 Allow full access。开启后，Agent 可以直接启动 ego (lite) 并发送本机浏览器指令，执行过程中无需逐步等待确认。

TUI

在 Terminal 中启动 CodeBuddy Code 时加入 --dangerously-skip-permissions，即可开启对应的权限模式。进入 TUI 后，请确认底部状态栏显示 bypass permissions on。

第 2 步：加载 ego-browser Skill

桌面端

输入 /ego-browser，从列表中选择 ego-browser。WorkBuddy 会将该 Skill 作为标签加入当前消息。继续在同一个输入框中写入浏览器任务，然后一并提交。

加载后，WorkBuddy 可以启动 ego (lite)、创建 Agent Space，并操作该 Space 中的网页。

TUI

上方素材展示的是 CodeBuddy Code TUI 操作流程。在终端会话中加载 ego-browser，然后发送浏览器任务。Skill 随后会启动 ego (lite)、创建 Agent Space，并操作该 Space 中的网页。

第 3 步：让 WorkBuddy 执行浏览器任务

将任务交给 WorkBuddy。Agent 会通过 ego-browser 在 ego (lite) 中打开 Anthropic 的 X 主页，读取指定的帖子，并将结果整理到 WorkBuddy 对话中。

桌面端和 CodeBuddy Code TUI 都可以使用相同的任务指令。

第 4 步：完成任务

任务完成后，WorkBuddy 会返回五条帖子的可见信息、对应链接和简要内容概括。Anthropic 的 X 主页会继续保留在 ego (lite) 中，本次浏览器任务至此完成。

常见问题

找不到 `ego-browser`

请确认 ~/.codebuddy/skills/ego-browser/SKILL.md 已存在，然后完全退出并重新启动 WorkBuddy 或 CodeBuddy Code。

已加载 Skill，但 ego (lite) 没有启动

桌面端请确认权限菜单显示为 Allow full access。Terminal 请关闭当前会话，再通过 --dangerously-skip-permissions 重新启动 CodeBuddy Code。

Terminal 找不到 `codebuddy` 命令

可以直接使用 WorkBuddy 内置 CLI，路径为 /Applications/WorkBuddy AI.app/Contents/Resources/app.asar.unpacked/cli/bin/codebuddy；也可以先全局安装 CodeBuddy Code，再使用较短的 codebuddy 命令。

TUI 打开了错误的项目

退出 CodeBuddy Code，在 Terminal 中进入正确的项目目录，然后重新运行启动命令。CodeBuddy Code 会将当前目录作为项目上下文。

X 要求登录或验证账号

请在 ego (lite) 的 Agent Space 中完成登录或验证，然后让 WorkBuddy 继续执行任务。