ego lite
github.com/citrolabs/ego-lite- Category
- Developer Tools
- Rank
- No. 760Tools index
- Pricing
- Free
- Platform
- desktop · cli
- Type
- TOOL
- Builder
- citrolabs
- GitHub
- 16.3k stars
- Latest release
- v2.0.0
- Date
About
A macOS browser designed to be shared between a human and AI agents, letting agents like Claude Code or Codex run browser automation tasks in isolated 'Spaces' while inheriting the user's real logins, cookies, and browsing data without disrupting their own tabs. It exposes browser control as JavaScript functions via the ego-browser skill, claiming up to 2.5x faster task completion with fewer tokens than frameworks like agent-browser.
What it does
Ego lite turns browser work into short JavaScript programs that an external coding agent writes and runs. It supplies page navigation, semantic element selection, snapshots, screenshots, network waits, file input, and task-space controls. Those controls let people pause automation, take over a task, review its result, or return control to the agent.
Why it's ranked here
The design has real substance beyond its speed pitch. Agents can compose several browser steps into one execution, while snapshots and locator chains reduce brittle coordinate-based interaction. The repository also handles ownership changes as explicit hard stops. However, the performance evidence is a project-run comparison covering only four complex tasks, so the headline advantage remains narrowly supported.
What's good
The interaction surface covers more than clicks and navigation. It includes accessibility-based locators, request and response waits, downloads, screenshots, browser-context fetching, and raw protocol access. Task ownership is especially thoughtful: user takeover halts commands, suppresses repeated error noise, and requires explicit permission before the agent resumes. Tests confirm locator chains remain usable through the SDK wrapper.
Tradeoffs
Only macOS is supported now, although downloads cover Apple Silicon and Intel hardware. Windows and Linux remain roadmap items. The browser itself is a separate free download from the MIT-licensed repository contents. Chrome-data migration grants access to logins, cookies, extensions, and bookmarks, which is useful but deserves deliberate consent. Experience accumulation is described as coming soon, not current functionality.
How to use it well
Use it when coding agents repeatedly operate authenticated sites and you want compact, scriptable browser runs with clear human takeover. Prefer semantic locators, page-state waits, and dedicated task spaces, then keep completed spaces open when a person should verify the result. It does not cover Windows or Linux workflows, and it is not a browser-neutral automation library.
Technical notes+
package/ego-browser/src/run.ts reads JavaScript from stdin, builds an AsyncFunction with the helper context, buffers console output, and always stops screencasting after execution. package/ego-browser/src/index.ts exposes both CLI and SDK surfaces, wraps helpers behind a readiness signal, preserves synchronous locator factories, and invalidates sessions after tab or task-space changes. package/ego-browser/src/cdp-eval.ts sends Chrome DevTools Protocol commands and evaluates serializable page expressions. package/ego-browser/src/ego-errors.ts classifies native failures with stable codes, while package/ego-browser/src/output-sink.ts collapses takeover failures into one hard-stop message. package/ego-browser/scripts/build.mjs targets Node 22, builds with esbuild and Rollup, embeds generated help documentation, and bundles the skill. package/ego-browser/src/index.test.mjs exercises SDK wrapping, asynchronous URL behavior, and the learnings facade.
Observed
- License
- Repository contents use the MIT License; the browser is distributed separately as a free download.
- Primary language
- TypeScript, with JavaScript module files used for tests and build scripts.
- Install surface
- macOS DMG downloads for Apple Silicon and Intel, plus skill installation through npx.
- Interfaces
- Command-line heredoc runner and importable SDK surface for JavaScript agents.
- Platform support
- macOS only; Windows and Linux are roadmap items.
- Browser protocol
- Browser operations are carried through Chrome DevTools Protocol commands.
- Testing
- The supplied repository text includes Node test coverage for SDK installation behavior.
Read from README.md, package/ego-browser/src/env.ts, package/ego-browser/src/run.ts, package/ego-browser/src/http.ts, package/ego-browser/src/index.ts, package/ego-browser/src/state.ts, package/ego-browser/src/format.ts, package/ego-browser/src/helpers.ts, package/ego-browser/src/ref-map.ts, package/ego-browser/src/cdp-eval.ts, package/ego-browser/src/ref-state.ts, package/ego-browser/scripts/build.mjs, package/ego-browser/src/ego-errors.ts, package/ego-browser/src/index.test.mjs, package/ego-browser/src/output-sink.ts.
What it can do
Run AI agent browser automation tasks in isolated Spaces
Automation task instructions → Completed browser task
Expose browser control functions for AI agents to call
JavaScript function calls → Browser actions
Tags
Media
Comments (0)
No comments yet
Editorially curated, with community endorsements as a secondary signal. Corrections welcome.