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 Claude Code

Set up Claude Code browser automation with ego (lite). Switch from Cowork to Code, enable Bypass permissions, load ego-browser, and complete a browser task.

llms.txt

Claude Code browser automation with ego (lite) works from a local Code session. Cowork and Code sit in the same desktop app, which makes the first failure confusing: /ego-browser appears in Code but not in the Cowork menu shown in this guide. The full video runs through the fix from start to finish.

The example opens Anthropic's X profile in an ego (lite) agent Space, reads five visible posts, and returns the result to Claude Code.

Before you start: install ego (lite)

Start with ego (lite) installed and its onboarding finished. You also need Claude Code in the desktop app or terminal.

  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 Claude Code in the desktop app, or start Claude Code in your terminal

Onboarding writes the ego-browser skill to ~/.claude/skills/. If Claude was already open, quit and reopen it so the skill list refreshes.

Use Code, not Cowork

Cowork and Code are separate modes in Claude Desktop. The local ego-browser skill is made for Claude Code, so it will not appear in the Cowork skill menu. Open the mode switcher in the top-left corner, change Cowork to Code, and open a project or folder before continuing.

ego (lite) installs the skill for Claude Code at ~/.claude/skills/. If /ego-browser is missing in Cowork, the installation has not necessarily failed. Switch to Code and look for the Skill again.

Step 1: Enable Bypass permissions

Desktop

In the Code session, open the permission selector beside the input box and choose Bypass permissions. Once it's on, Claude Code can run the corresponding commands on your computer to start ego (lite) and carry out the corresponding browser automation tasks, without waiting for confirmation at every step.

TUI

For the TUI, start Claude Code with:

claude --dangerously-skip-permissions

When the TUI opens, the status line displays bypass permissions on.

Step 2: Load the ego-browser skill

Desktop

The recording shows the Desktop workflow: leave Cowork, open Code, type /ego-browser, and select the Skill. Once loaded, it can open ego (lite), create an agent Space, and operate pages inside that Space.

TUI

In the TUI, enter /ego-browser, keep a space after the Skill name, and add the browser task in the same message. Submit the message to let Claude Code load the Skill and start the task.

Step 3: Let your AI agent work

Now hand the task to Claude Code. The agent will use ego-browser to open the target page in ego (lite), collect the requested information, and return the result when the task is complete.

Step 4: Complete the task

When the task is complete, Claude Code returns five posts in the conversation, along with their links, the like counts shown on the page, and a summary of the main topics. ego (lite) keeps Anthropic's X profile open so the source remains available. Claude Code has now completed the browser task through ego (lite).

Troubleshooting

/ego-browser is missing

Make sure the session is in Code, not Cowork. If ego (lite) finished onboarding while Claude was open, restart Claude and type /ego again.

Bypass permissions isn't listed

Open Settings > Claude Code and enable Allow bypass permissions mode. Team or Enterprise policy can hide the option, so ask your administrator if the setting is locked.

Claude Code loads the skill but ego (lite) doesn't open

Check the permission mode next to the input box. ego (lite) can only be controlled normally when Claude has Bypass permissions turned on. If you're using the terminal version, close the current session and restart it with claude --dangerously-skip-permissions. If you're using the desktop app, choose Bypass permissions in the permission selector. If none of this lets Claude control ego (lite), please reach us on Discord — we'll do our best to help.

X asks for a login or verification

Take over in the ego (lite) agent Space, finish the login or verification yourself, and then tell Claude Code to continue. Never paste a password or verification code into the prompt.

Go deeper