Repolode
citrolabs

citrolabs/ego-lite

A browser built for AI agents and you to share: agents run tasks in isolated Spaces while your own tabs and logins stay untouched.

Stars
17,677
Forks
964
Open issues
206
Last commit
yesterday

What is it?

ego lite is a desktop browser for macOS and Windows where you and your AI agents work in parallel. Each agent runs its browser tasks in its own isolated Space inside the same browser, so an agent never takes control of the window you are using. Agents can reuse your existing logins, cookies and bookmarks, which can be imported from Chrome on first launch.

Agents connect through the ego-browser skill, which works with agent CLIs such as Claude Code, Codex and Cursor. Instead of issuing one command at a time, the agent writes a JavaScript snippet that calls in-page tools for snapshot, fill, click, wait, navigate and capture, and runs it on the page in one pass. Page snapshots are structured text the model can read.

The project positions itself against browser bridges like browser-use and agent-browser, which need a separate browser and often lose your login state. Browsing data stays on your device.

Key features

  • 01Each agent gets an isolated Space, so agents and your own browsing do not interfere.
  • 02Reuses your Chrome logins, cookies, extensions and bookmarks after import.
  • 03ego-browser lets agents like Claude Code, Codex and Cursor drive the browser through JavaScript.
  • 04Runs multi-step tasks as a single script instead of many back-and-forth tool calls.
  • 05Supports running multiple agent tasks in parallel across separate Spaces.
  • 06Browsing data is stored locally on your device.

Use cases

  • Letting Claude Code or Codex fill in forms or scrape pages while you keep browsing.
  • Running several parallel scraping or research tasks across different sites.
  • Automating web tasks that require your existing logged-in accounts.
  • Reducing CAPTCHA friction for agent tasks on sites you already use.

Quick start

  1. 1

    Install the ego-browser skill with npx

    npx skills add citrolabs/ego-lite
  2. 2

    Download the ego lite app for your platform from the download links

  3. 3

    In your agent CLI, type /ego-browser followed by a task in plain language

Things to know

  • Runs on macOS and Windows only; Linux is on the roadmap.
  • The browser app is a separate download from the MIT-licensed repository.
  • Some advertised features, such as experience accumulation, are marked as coming soon.

Topics

FAQ

What is ego-lite?
A browser built for AI agents and you to share: agents run tasks in isolated Spaces while your own tabs and logins stay untouched. ego lite is a desktop browser for macOS and Windows where you and your AI agents work in parallel. Each agent runs its browser tasks in its own isolated Space inside the same browser, so an agent never takes control of the window you are using. Agents can reuse your existing logins, cookies and bookmarks, which can be imported from Chrome on first launch.
Is ego-lite free to use? What license does it have?
ego-lite is open source under the MIT license. Check the license terms before using it in commercial products.
Is ego-lite still maintained?
Actively maintained. The last commit to ego-lite was on Oct 19, 2026.
What can I use ego-lite for?
Letting Claude Code or Codex fill in forms or scrape pages while you keep browsing. Running several parallel scraping or research tasks across different sites. Automating web tasks that require your existing logged-in accounts. Reducing CAPTCHA friction for agent tasks on sites you already use.
How do I install ego-lite?
Install the ego-browser skill with npx: npx skills add citrolabs/ego-lite Download the ego lite app for your platform from the download links In your agent CLI, type /ego-browser followed by a task in plain language
Where can I get ego-lite?
The source code and installation instructions are on GitHub: https://github.com/citrolabs/ego-lite

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects