WorkBuddy 使用指南

設定 WorkBuddy 搭配 ego (lite)：啟用 Allow full access、載入 ego-browser，並完成一項瀏覽器任務。

WorkBuddy 可以操作 ego (lite)，並在獨立的 Agent Space 中執行任務。本指南以 Anthropic 的 X 個人檔案為例，讀取前五則貼文，再將結果傳回對話。上方完整影片展示桌面版流程。若產品支援 TUI，兩種介面可使用相同的 Skill 與任務指令。

開始前：安裝 ego (lite)

開啟 WorkBuddy 前，請先安裝 ego (lite) 並完成初始設定。

下載並開啟 DMG 安裝檔
按照指示，按兩下 ego (lite) 的 icon 進行安裝
開啟 ego (lite) 並完成初始設定
在 WorkBuddy 中開啟專案或工作區

ego (lite) 會將 ego-browser 安裝到 ~/.agents/skills/，而 CodeBuddy Code 會從 ~/.codebuddy/skills/ego-browser/ 載入 Skill。如果找不到 Skill，請將 ~/.agents/skills/ego-browser/ 複製到 ~/.codebuddy/skills/ego-browser/，再重新啟動 WorkBuddy。

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

選擇桌面版或 TUI

使用桌面版時，請開啟專案並建立新工作階段。使用 TUI 時，請在終端機切換至專案目錄，再執行：

codebuddy --dangerously-skip-permissions

如果使用 WorkBuddy macOS 應用程式內建的 CLI，請執行以下指令：

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

進入 TUI 後，底部狀態列會顯示 bypass permissions on。

第 1 步：啟用 Allow full access

桌面版

開啟 任務輸入框下方的權限選單，選擇 Allow full access。之後 WorkBuddy 就能啟動 ego (lite) 並傳送本機瀏覽器指令，不必在每個步驟等待確認。

TUI

使用 codebuddy --dangerously-skip-permissions 建立新工作階段。TUI 啟動後會略過權限確認。

第 2 步：載入 ego-browser Skill

桌面版

WorkBuddy 會將 Skill 以標籤形式加入目前的訊息。請繼續在同一個輸入框中寫入瀏覽器任務，再一併送出。

輸入 /ego-browser，再選擇 ego-browser。Skill 會開啟 ego (lite)、建立 Agent Space，並操作該 Space 中的網頁。

TUI

在 TUI 中載入 ego-browser，再輸入瀏覽器任務。Skill 在 TUI 與桌面版中的運作方式相同。

第 3 步：交給 Agent 執行

將任務交給 WorkBuddy。Agent 會透過 ego-browser 在 ego (lite) 中開啟 Anthropic 的 X 個人檔案、讀取指定貼文，並在對話中整理結果。

WorkBuddy 桌面版和 CodeBuddy Code TUI 都可以使用相同的任務指令。

第 4 步：完成任務

執行完成後，WorkBuddy 會傳回五則貼文，包括畫面上可見的資訊、直接連結和簡短摘要。Anthropic 的 X 個人檔案會繼續保留在 ego (lite) 中，至此任務已完成。

疑難排解

找不到 `ego-browser`

請確認 ego (lite) 已完成初始設定，而且 Skill 位於 ~/.codebuddy/skills/，再重新啟動 WorkBuddy。

Skill 已載入，但 ego (lite) 沒有開啟

請確認 Allow full access 已啟用。使用 TUI 時，請結束目前工作階段，再以 codebuddy --dangerously-skip-permissions 重新啟動。

終端機找不到 `codebuddy` 指令

請使用 WorkBuddy 內建的 CLI，路徑為 /Applications/WorkBuddy AI.app/Contents/Resources/app.asar.unpacked/cli/bin/codebuddy；也可以先全域安裝 CodeBuddy Code，再使用較短的 codebuddy 指令。

TUI 開啟了錯誤的專案

結束 CodeBuddy Code，在終端機切換至正確的專案目錄，再重新執行啟動指令。CodeBuddy Code 會將目前目錄作為專案內容。

X 要求登入或驗證

請直接在 ego (lite) 的 Agent Space 中完成登入或驗證，再讓 WorkBuddy 繼續執行。