# ego (lite) — Full Documentation > Daily browser for you, agent browser for your AI agents. Runs browser automation tasks in parallel on real Chrome, much faster, cheaper than agent-browser. ## Company ego (lite) is built by Citro Labs. Repository: https://github.com/citrolabs/ego-lite (MIT). Contact via repo issues or @ego_agent on X. ## Product Overview ego (lite) is a Chromium browser built for you and your AI agent to work together, making browser automation faster and cheaper, every run. Existing tools like Browser Use and Vercel's agent-browser are browser automation frameworks. They need a separate browser to drive, logins never carry cleanly, and you and the agent end up fighting for the same tabs. ChatGPT Atlas and Perplexity Comet take the opposite approach: AI-first browsers that ship with their own built-in assistant, which locks you into that one agent. ego (lite) is one browser designed from the start for you and your AI agent to share — no extra setup, and the agent can always reach your real logins and tabs through ego-browser. ### What Makes ego (lite) Different 1. **Run faster, cost fewer tokens** — Complex browser automation tasks complete faster and on fewer tokens overall (the saving is on the whole task, not per step). Several features stack to make that happen. Each page reaches the agent as a Snapshot, an accessibility tree with stable @N refs, instead of raw HTML. The agent can also run several actions in the page with a few lines of JavaScript, instead of calling one tool at a time and waiting for each result before deciding the next, the way Playwright, Puppeteer, and most browser automation frameworks work. 2. **Spaces** — Workspaces you and your agent can use independently inside the same browser. Group your tabs by project; the agent runs background tasks in a separate Space without stealing focus or touching your active tabs. 3. **Same Chrome, agent-native** — Built on Chromium, imports your Chrome profile in one click (tabs, bookmarks, passwords, extensions, cookies, login sessions, profiles). Use it as your default browser. Your AI agent inherits the same logged-in state, so it doesn't get stuck on captchas, 2FA, or SSO redirects. 4. **ego-browser, open source** — Shell-level entry point for any agent that writes codes: ego, Claude Code, Codex, Cursor, Continue, Gemini CLI, Hermes Agent, OpenClaw, Opencode, or any custom in-house agent. No SDK, no credentials, no platform-specific adapters to maintain. ## Key Capabilities ### Snapshot — Compressed Semantic Input Instead of feeding the LLM raw HTML (often 10k+ tokens of layout noise), ego (lite) emits an accessibility tree snapshot: - Stable element refs (@e1, @e2, …) survive minor DOM changes - Only interactive / labeled elements included - Typical page snapshot is dramatically smaller than the equivalent HTML - Works on JS-rendered, login-gated, or interactive content where `fetch` returns shells The snapshot is built inside our custom Chromium engine, not as a JavaScript shim on stock Chrome, so it reaches into cross-origin iframes, shadow DOM, and third-party SDK widgets (Stripe checkouts, Salesforce embeds, intercom panels, dynamically mounted React portals) that JS-based snapshotters silently drop. ### Multi-action JavaScript The agent can run several actions in the page with a few lines of JavaScript, instead of calling one tool at a time and waiting for each result before deciding the next. This is the largest contributor to ego (lite) finishing complex browser automation tasks faster and on fewer tokens overall, relative to Playwright, Puppeteer, or other automation frameworks that round-trip a single tool call per action. ### Space — Isolated Workspace A Space is a workspace partition inside the same browser process. You have your Space (active tabs, projects). The AI agent has its own Spaces (running tasks). Tabs in agent Spaces don't steal focus, don't push notifications into your view, and can be created or destroyed by the agent without affecting your daily browsing. You can run multiple Spaces in parallel — Claude Code in one, Codex in another, you in your own tabs in a third. ### Open ego-browser Runtime `ego-browser` is the shell-level entry: `ego-browser open`, `ego-browser click @e3`, `ego-browser snapshot`, etc. Any agent that can spawn a child process can drive the browser. Plugs in as a skill into Claude Code, Codex, Cursor, Continue, Gemini CLI, Hermes Agent, OpenClaw, Opencode, or your custom agent. No SDK to integrate, and you're not locked into a specific model. ## Use Cases - **Engineer — E2E testing after a code change** — Reuses the staging cookie already in your browser. The agent runs the full flow in a Space, logs in as the test user, walks every step, and captures screenshots, console errors, and network requests, while you keep coding in Cursor. - **Marketer — daily competitor pulse** — Same browser already signed into Instagram, LinkedIn, and Facebook. The agent opens parallel tabs across competitors and channels, captures 24h posts and engagement, and writes a daily markdown brief to disk. - **Sales AE — morning battle card** — Reuses your active LinkedIn, Crunchbase, X, and HubSpot logins. The agent enriches today's inbound leads and rechecks stale prospects in parallel Spaces. - **PM — daily product pulse** — Already signed into Discord, App Store, Reddit, and your team tools. The agent runs source checks in parallel Spaces (competitor changelogs, X, Product Hunt, Hacker News, your App Store reviews) and writes the daily pulse markdown to your Notion mirror. - **Job seeker — daily roles and company intel** — Reuses existing logins and saved searches on LinkedIn Jobs, YC Work at a Startup, Wellfound, Levels.fyi, and Glassdoor. The agent scrapes new roles, enriches each with funding round and Glassdoor score, then appends to your tracker. ## Roadmap Roadmap page: https://www.lite.ego.app/roadmap. It tracks the current beta priorities, active feature work, and the request flow. The public roadmap can be backed by a Tally embed through `NEXT_PUBLIC_TALLY_ROADMAP_URL`, with feature requests optionally routed through `NEXT_PUBLIC_TALLY_REQUEST_URL`. ## Comparison | Feature | ego (lite) | Browser Use | Agent Browser | ChatGPT Atlas | Perplexity Comet | |---|---|---|---|---|---| | Inherits Chrome data | ✓ | — | — | — | — | | Same browser, separate workspace | ✓ | — | — | — | — | | Compressed semantic input | ✓ | — | ✓ | — | — | | Controllable by external agents | ✓ | ✓ | ✓ | — | — | | Data stored locally | ✓ | ✓ | ✓ | — | — | | No login friction | ✓ | — | — | ✓ | ✓ | | Daily-use browser | ✓ | — | — | ✓ | ✓ | | Free, no subscription | ✓ | ✓ | ✓ | — | — | ## Privacy - Profile data, cookies, and migrated browser state live on your local disk - ego (lite) does not upload your browsing data; the only thing it records during setup is whether you opted into Chrome data migration - The AI agent runs queries through whichever LLM you configure (Claude, OpenAI, …); Citro Labs does not proxy or log those calls - No third-party advertising, no data sold or used for model training ## FAQ ### What is ego lite? ego lite is a Chromium browser built for you and your AI agent to work together, making browser automation faster and cheaper, every run. Existing tools like browser-use and agent-browser are browser automation frameworks. They need a separate browser to drive, logins never carry cleanly, and you and the agent end up fighting for the same tabs. ego lite is one browser designed from the start for the two of you to share — no extra setup, and the agent can always reach your real logins and tabs through ego-browser. ### How is ego lite different from Playwright or Puppeteer? Playwright and Puppeteer are browser automation libraries you embed in code. They drive pages through CSS selectors, which break whenever a site reshuffles its DOM. ego lite is a real browser plus ego-browser. ego-browser is the connection layer between any agent CLI (Claude Code, Codex, Cursor, or your own) and ego lite — it exposes the browser as a set of in-page JavaScript tools: snapshot, fill, click, wait, navigate, capture. The agent writes a JavaScript snippet that composes several steps using those tools, and ego-browser runs it on the page in one pass, instead of the one-tool-at-a-time round trips Playwright and Puppeteer require. The snapshots cost fewer tokens than HTML, and the @N refs stay stable when class names rotate. There's no SDK to integrate, and nothing to install from the Playwright or Puppeteer ecosystem. ### How is ego lite different from browser-use or Vercel's agent-browser? ego lite is a real browser plus ego-browser. Whichever agent you use, whether that's ego, Claude Code, Codex, Cursor, or something else, drives the same browser you use daily. Space keeps the agent's work isolated from yours. Browser-Use is an autonomous agent framework. It bundles its own LLM loop and drives a separate browser instance. You can point it at a real Chrome, but only after you fully close it. Extensions don't load by default. And it has its own pricing tier on top of whatever you already pay for. Vercel's agent-browser is a CLI that lets your agent control a browser through shell commands, but it ships no browser of its own. The agent doesn't share your daily browser session, so your real logins aren't available to the running task. ### Does ego lite work with Claude Code, Codex, and Cursor? Yes. Any agent that can run a shell command can drive ego lite through ego-browser: • ego, Claude Code, OpenAI Codex, Cursor, Continue, Gemini CLI • Hermes Agent, OpenClaw, Opencode • Any custom in-house agent you've built ego-browser installs as a skill into your agent's skill directory during onboarding. The agent then calls browser automation commands the same way it runs any other shell tool. There's no SDK to integrate, and you're not locked into a specific model. ### Can ego lite replace Chrome as my main browser? Yes. ego lite is built on Chromium, so the address bar, tab groups, bookmarks, profiles, extensions, downloads, and incognito mode behave the way they do in Chrome. The difference is Space: an isolated workspace where your AI agent runs web automation alongside you, and doesn't touch your tabs unless you let it. ### Can I bring my Chrome bookmarks, passwords, and extensions into ego lite? Yes. ego lite's onboarding migrates the following from Chrome in one click: • Tabs and tab groups you're using • Bookmarks and saved passwords • Browser extensions • Cookies and login sessions • Browser profiles Every site you've already signed into stays signed in, and the agent inherits the same logged-in state. It doesn't need to re-authenticate to Gmail, Notion, LinkedIn, or your internal tools every time it runs a task. ### Can I keep using my browser while the agent runs tasks? Yes. The agent runs inside Space, an isolated workspace in ego lite. It works in its own area, so your tabs stay untouched unless you explicitly hand one over. It doesn't take over your mouse or steal focus from whatever you're doing. Switch into Space anytime to watch the agent work, or ignore it and keep working in your own window. ### How does ego lite reduce token usage for browser automation? What gets cheaper is the whole task, not any single step. The savings come from several features stacking together. The agent can run several actions in the page with a few lines of JavaScript, instead of calling one tool at a time and waiting for each result before deciding the next, the way Playwright, Puppeteer, and most browser automation frameworks work. Combined, complex browser automation tasks complete faster and on fewer tokens overall. ### Is my data safe when an AI agent uses ego lite? Yes. ego lite doesn't upload your browsing data. Your history, cookies, login sessions, and anything the agent reads stay on your own computer. The one thing ego lite records during setup is whether you opted into Chrome data migration. ## Links - Website: https://www.lite.ego.app - Documentation: https://www.lite.ego.app/document/ - Roadmap: https://www.lite.ego.app/roadmap - Documentation llms.txt: https://www.lite.ego.app/document/llms.txt - GitHub: https://github.com/citrolabs/ego-lite - X / Twitter: https://x.com/ego_agent - Sitemap: https://www.lite.ego.app/sitemap.xml - robots.txt: https://www.lite.ego.app/robots.txt - llms.txt: https://www.lite.ego.app/llms.txt ## Contact For partnerships, press, or integration questions, open an issue on the GitHub repo or reach @ego_agent on X.