ego (lite) is just a browser, ego is your personal agent across devices.
Join waitlist
Download for Mac
English
EnglishFrançaisDeutsch简体中文繁體中文日本語한국어РусскийPortuguêsEspañolItalianoहिन्दी
Solutions
DocsEnterpriseChangelogBlog

How to use ego (lite) with WorkBuddy

Set up WorkBuddy browser automation with ego (lite). Enable Full Access, load ego-browser in Desktop or CodeBuddy Code, and complete a browser task.

llms.txt

WorkBuddy can control ego (lite) from its desktop app or through CodeBuddy Code in Terminal. In this guide, WorkBuddy opens Anthropic's X profile in an ego (lite) agent Space, reads the first five posts, and returns the result in the conversation.

The complete video above follows the Desktop workflow. The Terminal workflow uses the same ego-browser skill and task instructions.

Before you start: install ego (lite)

Install ego (lite) and finish onboarding before opening WorkBuddy.

  1. Download the DMG and open it
  2. Follow the instructions and double-click the ego (lite) icon to install
  3. Open ego (lite) and finish onboarding
  4. Open a workspace in WorkBuddy Desktop, or change to the project directory before starting CodeBuddy Code in Terminal

ego (lite) installs ego-browser under ~/.agents/skills/. WorkBuddy and CodeBuddy Code read user skills from ~/.codebuddy/skills/. If /ego-browser is not available, copy the installed skill into WorkBuddy's skill directory:

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

Restart WorkBuddy after copying the skill.

Choose WorkBuddy Desktop or Terminal

For Desktop, select a workspace and start a new task. For Terminal, change to the project directory and start CodeBuddy Code with bypass permissions enabled:

codebuddy --dangerously-skip-permissions

If you use the CLI bundled with the WorkBuddy macOS app instead of a global installation, run:

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

When the TUI opens, the status line displays bypass permissions on. WorkBuddy Desktop and CodeBuddy Code can now use the same /ego-browser command.

Step 1: Enable Full Access

Desktop

In WorkBuddy Desktop, open the permission menu below the task box and switch Default Permission to Allow full access. This allows the Agent to start ego (lite) and send local browser commands without stopping for approval at each step.

TUI

In Terminal, enable the equivalent permission mode by starting CodeBuddy Code with --dangerously-skip-permissions. When the TUI opens, confirm that the status line displays bypass permissions on.

Step 2: Load the ego-browser skill

Desktop

Enter /ego-browser and select ego-browser from the list. WorkBuddy adds the skill to the current message as a label. Continue writing the browser task in the same message, then submit it.

The skill gives WorkBuddy the instructions it needs to open ego (lite), create an agent Space, and operate the page in that Space.

TUI

The recording above shows the CodeBuddy Code TUI workflow. Load ego-browser in the terminal session, then send the browser task. The Skill can then start ego (lite), create an agent Space, and operate the page in that Space.

Step 3: Let WorkBuddy complete the browser task

Give the task to WorkBuddy. The Agent will use ego-browser to open Anthropic's X profile in ego (lite), read the requested posts, and prepare the result in the WorkBuddy conversation.

The same task can be submitted from WorkBuddy Desktop or the CodeBuddy Code TUI.

Step 4: Complete the task

When the run finishes, WorkBuddy returns the five posts with their visible details, direct links, and a short summary of each post. Anthropic's X profile remains open in ego (lite), and the browser task is complete.

Troubleshooting

ego-browser does not appear

Confirm that the skill exists at ~/.codebuddy/skills/ego-browser/SKILL.md, then completely quit and reopen WorkBuddy or CodeBuddy Code.

WorkBuddy loads the skill but ego (lite) does not open

In Desktop, confirm that the permission menu shows Allow full access. In Terminal, close the current session and restart CodeBuddy Code with --dangerously-skip-permissions.

Terminal cannot find the codebuddy command

Use the CLI bundled with WorkBuddy at /Applications/WorkBuddy AI.app/Contents/Resources/app.asar.unpacked/cli/bin/codebuddy, or install CodeBuddy Code globally before using the shorter codebuddy command.

The TUI opens in the wrong project

Exit CodeBuddy Code, change to the correct project directory, and run the command again. The current directory becomes the project context.

X asks you to sign in or verify the account

Complete the login or verification in the ego (lite) agent Space, then ask WorkBuddy to continue the task.

Go deeper