ego-lite README

The project's README from github.com/citrolabs/ego-lite. As one markdown file: README.md.

ego lite

The fastest browser for AI agents to run browser automation

citrolabs%2Fego-lite | Trendshift

Download for Apple Silicon Download for Intel Discord Follow @ego_agent on X Docs License MIT

ego (lite) is a browser where you and your AI agents work in parallel. Your agents run multiple browser tasks in their own Spaces while your tabs stay yours, and tasks complete faster on fewer tokens.

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.

Demo

https://github.com/user-attachments/assets/ffe7954b-58ee-411e-b35d-ec30c58a08bc

Quick Start

ego lite runs on macOS today. Windows and Linux are on the roadmap.

1. Install

Pick whichever fits your flow.

1.1 Download the macOS app

Download ego lite for Apple Silicon Download ego lite for Intel

Click to download, then open it to install. Either way, ego lite adds the ego-browser skill to every agent's skills directory on your machine.

1.2 Add the skill with npx

Install just the ego-browser skill:

npx skills add citrolabs/ego-lite

The first time your agent runs a browser task, it walks you through installing the ego lite app.

1.3 Let your agent set it up

Paste this into your agent:

Set up ego lite for me: https://github.com/citrolabs/ego-lite

Read `skills/ego-browser/references/install.md` and follow the steps to install ego lite.

On first launch, ego lite asks one question, whether to migrate your Chrome data. Say yes and your agent inherits your existing logins, cookies, extensions, and bookmarks.

2. Run your first task

In your agent CLI, type /ego-browser followed by a space, then describe what you want in plain language:

ego-browser follow @ego_agent on x.com for me

The agent picks up the ego-browser skill, opens the page in its own Space, reads a Snapshot, acts on the page, and reports back, all while your own tabs stay untouched.

Your browsing data stays on your device. ego lite only records whether you opted into Chrome migration during setup.

Highlight of ego lite

Feature What it does
Code base, not CLI base, for faster runs with fewer tokens on complex tasks The capabilities ego lite exposes to the agent are wrapped as JavaScript functions the agent calls directly. The agent gets to do what it does best: write code, composing a multi-step task into a single output instead of getting stuck in a "call two commands, look at the result, call two more commands" loop. Compared to the conventional CLI approach, complex workflows finish up to 2.5× faster with higher task success rates and far fewer tool calls per task.
A dedicated Space for every agent ego lite gives each agent its own fully isolated Space. You browse up front, your agent works in the background, and they don't get in each other's way. You can see which Space has an agent running at any moment, and take it over or stop it whenever you want.
Your agents multitask in Spaces, parallel workspaces inside the same browser Each Space gets its own AI agent or its own task, all running at the same time. Claude Code enriching 10 leads in 10 parallel Spaces. Codex scraping 5 competitor sites in 5 more. They don't collide or steal your tabs. Your mouse stays where you left it.
The strongest page Snapshot on the market Thanks to kernel-level customization, ego lite produces the highest-quality page snapshots, the view text models rely on to "see" and act on a webpage. It reliably handles tough cases like deeply nested iframes, exactly where other approaches consistently break down.
Any agent can drive it through ego-browser ego-browser is the connection layer between any agent CLI (Claude Code, Codex, Cursor, or a custom one) 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 calling those tools, and ego-browser runs it on the page in one pass.
Experience accumulation that makes your agent faster the more you use it (coming soon) Most of an agent's time on browser tasks goes to trial and error. ego lite's official Skill distills every successful action into reusable tools and workflows, so similar tasks down the line run up to 5x faster.

ego lite vs existing products

Most tools can automate a browser. The real questions are what browser the agent gets, whether you can keep working at the same time, and whether the tool is built for the agent you already use or a built-in one.

Capability ego lite Browser-Use agent-browser (Vercel) ChatGPT Atlas Perplexity Comet
Multitask in parallel ✓ — — — —
Reusable skills ✓ — — — —
Inherits Chrome's data ✓ — — ✓ ✓
Same browser, separate workspace ✓ — — — —
Compressed semantic input ✓ — ✓ — —
Controllable by external agents ✓ ✓ ✓ — —
Data stored locally ✓ ✓ ✓ — —
No login friction ✓ — — ✓ ✓
Daily-use browser ✓ — — ✓ ✓
Free ✓ ✓ ✓ — —

Two other categories try to solve the same problem. Browser automation frameworks like Browser-Use and Vercel's agent-browser are libraries the agent calls; they ship no browser of their own, so they need a separate one to drive and your logins rarely carry cleanly. AI browsers like ChatGPT Atlas and Perplexity Comet ship a built-in agent, and only that agent can drive the browser. ego lite is one browser, designed from the start for you and any agent you bring to share.

Benchmarks

We benchmarked ego lite against Vercel's agent-browser on four complex browser automation tasks. ego lite finished each task up to 2.5× faster, with substantially fewer tokens. The harder the task, the bigger the gap. Check the comparison.

ego lite vs agent-browser, speed and cost across four tasks

Docs

Tutorials, the full tool reference, and integration guides live at lite.ego.app/document/.

Community

Star History

Star history

License

The contents of this repository are released under the MIT License. The ego lite browser is a separate, free download.

ego-lite (citrolabs/ego-lite)

Searching Database…

17.6K ·GitHub
这是什么?ego lite 是一款专为与 AI 编程智能体共用而设计的桌面浏览器:你的智能体在各自的 Space 里运行浏览器任务,而你自己的标签页仍归你自己所有。
这是一个浏览器应用,还是像 browser-use 那样的自动化库?它是一个完整的浏览器应用,不是框架——与 browser-use 或 Vercel 的 agent-browser 不同,它自带浏览器本体,智能体通过 ego-browser 技能连接到它。
怎么把它和我的编程智能体搭配起来用?有三种方式:下载 macOS 应用、通过 npx 只安装 ego-browser 技能,或者在你的智能体里粘贴一段安装提示词——无论哪种方式,技能都会装进每个智能体的 skills 目录。
哪些 AI 智能体可以驱动它?任何智能体 CLI 都行——Claude Code、Codex、Cursor 或自定义的——只要通过 ego-browser 连接层接入即可。
我 Chrome 的登录状态和扩展能迁移过来吗?可以——首次启动时 ego lite 只问一个问题:是否迁移你的 Chrome 数据;同意后,你的登录状态、Cookie、扩展和书签都会传给这个共享浏览器。
支持 Windows 或 Linux 吗?暂时不支持——ego lite 目前只能在 macOS 上运行,Windows 和 Linux 已列入路线图。
我的浏览数据会发到哪里?哪里都不去——你的浏览数据只留在你的设备上,ego lite 唯一会记录的是你在安装时是否选择迁移 Chrome 数据。
为什么 ego lite 说自己比基于 CLI 的浏览器自动化更快?它的能力被封装成智能体可直接调用的 JavaScript 函数,因此能把一个多步任务组合成一段代码,而不是那种调两条命令、看一眼结果、再调两条命令的循环。与 Vercel 的 agent-browser 对比的基准测试显示,复杂任务的完成速度最高提升 2.5 倍,消耗的 token 也少得多。
什么是 Spaces?它是同一个浏览器内完全隔离的并行工作区——每个智能体或任务都有自己的一份,所以 Claude Code 可以在多个 Space 里充实潜在客户信息,同时 Codex 在另外的 Space 里抓取竞争对手的网站。你能看到哪个 Space 里有智能体在运行,并随时接管或停止它。
智能体在页面上到底能做什么?ego-browser 把页面暴露为一组页内 JavaScript 工具:snapshot、fill、click、wait、navigate 和 capture。智能体编写一段代码调用这些工具,ego-browser 就在页面上一次性运行它。
除了 Windows 和 Linux 支持,路线图上还有什么?经验积累(即将推出):一个官方 Skill,会把每次成功的操作提炼成可复用的工具和工作流,让之后类似的任务最高提速 5 倍。
Creator
citrolabs
Size
7.3 MB
Stars
17.6K
Age
6mo
Commits · 90 Days