How to use ego (lite) with Hermes Agent
Set up Hermes Agent browser automation with ego (lite). Load ego-browser, enable bypass permissions in Desktop or the TUI, and complete a browser task.
Hermes Agent can control ego (lite) from its desktop app or the terminal interface. In this guide, Hermes 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 TUI uses the same ego-browser skill and task instructions.
Before you start: install ego (lite)
Install ego (lite) and finish onboarding before opening Hermes Agent.
- Download the DMG and open it
- Follow the instructions and double-click the ego (lite) icon to install
- Open ego (lite) and finish onboarding
- Open a workspace in Hermes Desktop, or change to the project directory before starting the Hermes TUI
ego (lite) installs ego-browser under ~/.agents/skills/. Hermes loads user skills from ~/.hermes/skills/. If /ego-browser is not available, copy the installed skill into the Hermes skills directory:
mkdir -p ~/.hermes/skills/ego-browser
cp -R ~/.agents/skills/ego-browser/. ~/.hermes/skills/ego-browser/
Restart Hermes after copying the skill.
Choose Hermes Desktop or the TUI
For Desktop, open a workspace and start a new session. For the TUI, open Terminal in the project directory and run:
hermes --tui --yolo
The --yolo flag starts the session with approval prompts bypassed. Desktop uses the Approval Mode setting described below.
Step 1: Enable bypass permissions
Desktop
In Hermes Desktop, open Settings > Safety and set Approval Mode to Smart.
TUI
In Terminal, start Hermes with hermes --tui --yolo. The --yolo flag launches the TUI with approval prompts bypassed.
Step 2: Load the ego-browser skill
Desktop
Enter /ego-browser and select ego-browser from the list. Continue writing the browser task after the skill name, then submit the message.
Keep a space between /ego-browser and the task. For example: /ego-browser Use ego-browser to open Anthropic's official X profile and collect the first five posts shown in the Posts feed.
TUI
The recording above shows the Hermes TUI workflow. Load ego-browser in the terminal session, keep a space after the Skill name, and then enter the browser task. Hermes will use the loaded Skill to control ego (lite).
Step 3: Let Hermes Agent complete the browser task
Give the task to Hermes Agent. 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 Hermes conversation.
The same task works in Hermes Desktop and the TUI.
Step 4: Complete the task
When the run finishes, Hermes Agent 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 ~/.hermes/skills/ego-browser/SKILL.md exists, then restart Hermes. In an active TUI session, you can also run /reload-skills and start a new session.
Hermes loads the skill but ego (lite) does not open
In Desktop, confirm that Settings > Safety > Approval Mode is set to Smart. In Terminal, close the current session and restart Hermes with hermes --tui --yolo.
Hermes reports an unknown command such as /ego-browserUse
Add a space after /ego-browser, or select the skill from the suggestion list before writing the task. Without the space, Hermes reads the skill name and the first word of the task as one command.
The TUI opens in the wrong project
Exit Hermes, change to the correct project directory, and run hermes --tui --yolo again. Hermes uses the current directory as the workspace for the new session.
X asks you to sign in or verify the account
Complete the login or verification in the ego (lite) Agent Space, then ask Hermes Agent to continue the task.
Go deeper
- Quick start: install ego (lite) and run your first browser task
- Claude Code browser automation: switch from Cowork to Code and enable bypass permissions
- Codex browser automation: use ego-browser from Codex Desktop or the TUI
- Cursor browser automation: run ego-browser from Cursor Agent
- OpenCode browser automation: use ego-browser from OpenCode Desktop or the TUI
- WorkBuddy browser automation: use ego-browser from WorkBuddy Desktop or CodeBuddy Code
- ego-browser: learn the browser helper commands
- Hermes Agent configuration: see the official approval modes and YOLO equivalent
- Hermes Agent skills: see how Hermes discovers and loads skills