← all repositories
citrolabs/ego-lite

A browser that lets your AI agent borrow your logins, not your mouse

ego lite is a macOS browser that isolates AI agents in parallel Spaces so they can automate the web with your real logins while your tabs stay untouched.

15.7k stars JavaScript AgentsCoding Assistants
ego-lite
Velocity · 7d
+133
★ / day
Trend
accelerating
star history

What it does

ego lite is a native macOS browser built for simultaneous human and AI use. It runs external agents in isolated background “Spaces” inside the same app, giving them access to your existing Chrome cookies, extensions, and bookmarks while your own tabs remain untouched. Agents drive it through the ego-browser skill, which exposes page actions as JavaScript functions they compose into scripts rather than step through one CLI command at a time.

The interesting bit

By treating browser automation as an in-page coding exercise instead of remote control, ego lite claims complex workflows finish up to 2.5× faster with fewer tokens than CLI-driven alternatives. The JavaScript interface also gives agents a high-fidelity snapshot of the DOM, including deeply nested iframes, which the README says is where other tools consistently break down.

Key highlights

  • Parallel Spaces — Each agent or task gets an isolated workspace inside the same browser; you can monitor, take over, or kill them without losing your own context.
  • Chrome inheritance — Optionally migrates your existing Chrome profile so agents inherit logins, cookies, and extensions without separate authentication flows.
  • JavaScript-first agent API — Agents compose multi-step tasks into single JS outputs using ego-browser tools, cutting back-and-forth tool calls.
  • Local-only data — Browsing data stays on the device; the only recorded telemetry is whether you opted into Chrome migration.
  • External agent agnostic — Works with Claude Code, Codex, Cursor, or custom agent CLIs through the same ego-browser skill interface.

Caveats

  • macOS only — The browser currently runs only on macOS (Apple Silicon and Intel); Windows and Linux are on the roadmap.
  • Experience accumulation is pending — A promised feature that distills successful actions into reusable workflows for up to 5× speedups on repeat tasks is marked “coming soon.”

Verdict

Worth installing if you’re already using Claude Code, Codex, or similar tools and tired of agents hijacking your mouse or expiring your SSO sessions in headless Chrome. If you’re on Windows or Linux, or you prefer agents to stay in sandboxed cloud containers, this isn’t for you yet.

Frequently asked

What is citrolabs/ego-lite?
ego lite is a macOS browser that isolates AI agents in parallel Spaces so they can automate the web with your real logins while your tabs stay untouched.
Is ego-lite open source?
Yes — citrolabs/ego-lite is open source, released under the MIT license.
What language is ego-lite written in?
citrolabs/ego-lite is primarily written in JavaScript.
How popular is ego-lite?
citrolabs/ego-lite has 15.7k stars on GitHub and is currently accelerating.
Where can I find ego-lite?
citrolabs/ego-lite is on GitHub at https://github.com/citrolabs/ego-lite.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.