首次运行代理任务时会引导你安装 ego lite 桌面应用,仅装 skill 不能直接用;首次启动会询问是否迁移 Chrome 数据,选是才能继承登录状态;目前不支持 Linux,仅 macOS 和 Windows 可用
ego-lite
citrolabsMIT活跃维护给 AI 代理用的极速浏览器自动化工具,能把已登录的浏览器状态直接共享给 Codex、Claude Code 等代理,不打扰你正常使用,零配置零成本。
The fastest browser for AI agents to run browser automation, built for sharing your logged-in browser state with your AI agents, like Codex or Claude Code, without disturbing you. Zero cost, zero config.
npx skills add citrolabs/ego-liteREADME 未说明硬件要求;软件支持 macOS(Apple Silicon 与 Intel)和 Windows x64,Linux 在路线图中
专为 AI 代理设计的浏览器,让代理在独立空间跑自动化,不抢你的标签页
给 AI 代理用的极速浏览器自动化工具,能把已登录的浏览器状态直接共享给 Codex、Claude Code 等代理,不打扰你正常使用,零配置零成本。
核心能力
- 每个代理分配独立 Space 隔离工作区,与你的浏览互不干扰
- 把浏览器能力封装成 JavaScript 函数供代理直接调用,减少工具调用次数
- 通过 ego-browser 技能层连接 Claude Code、Codex、Cursor 等任意代理 CLI
- 引擎级定制生成高质量页面 Snapshot,可处理深层嵌套 iframe
- 支持多个 Space 并行执行不同代理任务,互不冲突
容易踩的坑
- v2.2.0最新正式版2026-11-05 · 2026-11-05 02:45 UTC
What's Changed
Features
- perf(ego-browser): collapse click actionability checks into one injected call by @joway in https://github.com/citrolabs/ego-lite/pull/534
Fixes
- fix(ego-browser): isolate default screenshot paths across runs in the shared Node process by @joway in https://github.com/citrolabs/ego-lite/pull/492
Documentation
- docs: sync README benchmarks and comparison table with lite.ego.app, add a Windows download by @braxtonROSE4 in https://github.com/citrolabs/ego-lite/pull/486
Other Changes
- fix(ego-browser): scope page ledgers by browser instance by @joway in https://github.com/citrolabs/ego-lite/pull/466
- build(ego-browser): unwrap soft-wrapped prose in the printed usage guide by @joway in https://github.com/citrolabs/ego-lite/pull/469
- refactor(skill): split into entry Skill and versioned usage guide by @joway in https://github.com/citrolabs/ego-lite/pull/449
- fix(ego-browser): report stuck requests on networkidle timeouts and stop e2e budget cascades by @joway in https://github.com/citrolabs/ego-lite/pull/473
- fix(ego-browser): remind agents to release task spaces they still control by @joway in https://github.com/citrolabs/ego-lite/pull/474
- fix(ego-browser): list and claim user spaces that were never renamed by @joway in https://github.com/citrolabs/ego-lite/pull/475
- ci: allow release branches cut from dev to target main by @joway in https://github.com/citrolabs/ego-lite/pull/477
- fix(ego-browser): resume and detach every auto-attached non-frame target by @joway in https://github.com/citrolabs/ego-lite/pull/479
- fix(ego-browser): enable Ego automation hooks on every Page session by @joway in https://github.com/citrolabs/ego-lite/pull/480
- feat(skill): render a usage guide per operating system by @joway in https://github.com/citrolabs/ego-lite/pull/481
- Revert "fix(ego-browser): remind agents to release task spaces they still control" by @joway in https://github.com/citrolabs/ego-lite/pull/489
- feat(ego-browser): flag content outside the viewport in default snapshots by @joway in https://github.com/citrolabs/ego-lite/pull/494
- fix(ego-browser): fall back when wheel input cannot bring a target into view by @joway in https://github.com/citrolabs/ego-lite/pull/497
- perf(ego-browser): drop fixed settle delays from actions and fail fast on idle pages by @joway in https://github.com/citrolabs/ego-lite/pull/510
- refactor(ego-browser): use a six-digit suffix for default screenshot names by @joway in https://github.com/citrolabs/ego-lite/pull/511
- ci: add Codex PR review workflow by @joway in https://github.com/citrolabs/ego-lite/pull/526
- fix(ego-browser): retry transient rename errors when writing page ledgers by @joway in https://github.com/citrolabs/ego-lite/pull/531
- fix(ego-browser): bound session setup waits and name an unresponsive Page by @joway in https://github.com/citrolabs/ego-lite/pull/532
- fix(ci): restore Star History updates and round Y axis bounds by @yarin-zhang in https://github.com/citrolabs/ego-lite/pull/572
- fix(ego-browser): let finish() close the blank anchor tab left by the last Page close by @joway in https://github.com/citrolabs/ego-lite/pull/575
- fix(plugins): bring agent plugin packages up to current host specs by @WUXM5 in https://github.com/citrolabs/ego-lite/pull/576
- fix(ego-browser): retry a snapshot whose capture straddles a document commit by @joway in https://github.com/citrolabs/ego-lite/pull/585
- fix(ego-browser): share one guid-named download directory across Pages and processes by @joway in https://github.com/citrolabs/ego-lite/pull/587
- fix(plugins): keep published npm packages valid without republishing by @WUXM5 in https://github.com/citrolabs/ego-lite/pull/588
- feat(plugins): publish the npm packages under the @ego-lite scope by @WUXM5 in https://github.com/citrolabs/ego-lite/pull/589
- docs(readme): replace the top banner image by @braxtonR
- v2.1.02026-10-16 · 2026-10-16 03:22 UTC
查看更新说明
What's Changed
Other Changes
- Package ego-browser plugins for nine agent hosts by @section9-lab in https://github.com/citrolabs/ego-lite/pull/391
- 2.0.0 beta dev by @section9-lab in https://github.com/citrolabs/ego-lite/pull/392
- fix(plugins): make the Codex archive uploadable to the public plugin directory by @WUXM5 in https://github.com/citrolabs/ego-lite/pull/397
- chore: sync 2.0.0-beta-dev into dev by @WUXM5 in https://github.com/citrolabs/ego-lite/pull/402
- docs(i18n): localized READMEs in 8 languages, reviewed by native readers by @braxtonROSE4 in https://github.com/citrolabs/ego-lite/pull/406
- docs(i18n): add localized READMEs and refresh the English copy by @yarin-zhang in https://github.com/citrolabs/ego-lite/pull/407
- fix(ego-browser): require absolute paths for screenshot and fetch saveAs by @joway in https://github.com/citrolabs/ego-lite/pull/408
- fix(ego-browser): support keyboard.paste clipboard on Windows by @joway in https://github.com/citrolabs/ego-lite/pull/409
- docs(ego-browser): give PowerShell and cmd their own script-invocation form by @joway in https://github.com/citrolabs/ego-lite/pull/413
- fix(ego-browser): fail every renderer command fast while a JavaScript dialog is open by @joway in https://github.com/citrolabs/ego-lite/pull/415
- fix(ego-browser): reject invalid task-space locators before any native call by @joway in https://github.com/citrolabs/ego-lite/pull/419
- test(ego-browser): match the PDF viewer download icon on Chromium 154 by @joway in https://github.com/citrolabs/ego-lite/pull/420
- fix(ego-browser): only auto-wrap js() source with an outer return by @joway in https://github.com/citrolabs/ego-lite/pull/421
- fix(ego-browser): explain unknown Page labels in task-lifecycle terms by @joway in https://github.com/citrolabs/ego-lite/pull/423
- docs(ego-browser): show how to run later rounds from a script file by @joway in https://github.com/citrolabs/ego-lite/pull/424
- fix(ego-browser): stop attributing finished or handed-off tasks to the user by @joway in https://github.com/citrolabs/ego-lite/pull/450
- fix(ego-browser): report a user-owned task space name as in use by @joway in https://github.com/citrolabs/ego-lite/pull/452
- docs(skill): list the methods that accept a label option by @joway in https://github.com/citrolabs/ego-lite/pull/457
- release: v2.1.0 by @joway in https://github.com/citrolabs/ego-lite/pull/472
Full Changelog: https://github.com/citrolabs/ego-lite/compare/v2.0.0...v2.1.0
- v2.0.02026-09-10 · 2026-09-10 08:31 UTC
查看更新说明
What's Changed
Features
- release: merge dev into main by @section9-lab in https://github.com/citrolabs/ego-lite/pull/115
Fixes
- fix(ego-browser): contain fixture and subscriber failures by @section9-lab in https://github.com/citrolabs/ego-lite/pull/117
- ci(security): prevent shell injection via github.head_ref in Main PR Source by @shani-singh1 in https://github.com/citrolabs/ego-lite/pull/128
- fix(ego-browser): preserve iframe snapshots and Page ref identity by @section9-lab in https://github.com/citrolabs/ego-lite/pull/375
Documentation
- chore(github): add issue and pull request templates by @section9-lab in https://github.com/citrolabs/ego-lite/pull/114
- docs: clarify SDK development and refresh project links by @section9-lab in https://github.com/citrolabs/ego-lite/pull/383
Other Changes
- feat(ego-browser): add video recording and ticket-rush E2E by @section9-lab in https://github.com/citrolabs/ego-lite/pull/103
- docs(ego-browser): refine execution lifecycle guidance by @WUXM5 in https://github.com/citrolabs/ego-lite/pull/106
- ci: publish ego-browser skill from version tags by @section9-lab in https://github.com/citrolabs/ego-lite/pull/112
- fix(ego-browser): guide stale skill sessions by @WUXM5 in https://github.com/citrolabs/ego-lite/pull/121
- Update README tagline by @aute in https://github.com/citrolabs/ego-lite/pull/124
- docs: sync AGENTS with ego-browser runtime by @WUXM5 in https://github.com/citrolabs/ego-lite/pull/137
- docs: backport README tagline to dev by @WUXM5 in https://github.com/citrolabs/ego-lite/pull/138
- Update README.md by @section9-lab in https://github.com/citrolabs/ego-lite/pull/141
- Restore v1.2.3 SKILL.md text by @section9-lab in https://github.com/citrolabs/ego-lite/pull/147
- fix(ego-browser): toggle setChecked with a real click by @WUXM5 in https://github.com/citrolabs/ego-lite/pull/151
- docs: use browser automation wording by @section9-lab in https://github.com/citrolabs/ego-lite/pull/164
- docs: add Chinese and Japanese READMEs by @tura-ai-agent in https://github.com/citrolabs/ego-lite/pull/123
- Update README.md by @section9-lab in https://github.com/citrolabs/ego-lite/pull/247
- Update install.sh by @WUXM5 in https://github.com/citrolabs/ego-lite/pull/249
- Update README.md by @WUXM5 in https://github.com/citrolabs/ego-lite/pull/248
- feat(ci): self-host the star history chart by @yarin-zhang in https://github.com/citrolabs/ego-lite/pull/296
- feat(ci): self-host the star history chart, and let docs/* reach main by @yarin-zhang in https://github.com/citrolabs/ego-lite/pull/298
- fix(ci): publish the star history chart to its own branch by @yarin-zhang in https://github.com/citrolabs/ego-lite/pull/317
- fix(ego-browser): avoid dangling promise in update-notice stalled-probe test by @section9-lab in https://github.com/citrolabs/ego-lite/pull/323
- fix(ego-browser): pin keyboard test platform by @section9-lab in https://github.com/citrolabs/ego-lite/pull/324
- docs(ego-browser): add beta skill metadata by @section9-lab in https://github.com/citrolabs/ego-lite/pull/325
- fix(ci): reuse release build and strengthen local gates by @section9-lab in https://github.com/citrolabs/ego-lite/pull/326
- chore: relocate developer-only skill by @section9-lab in https://github.com/citrolabs/ego-lite/pull/327
- fix(ego-browser): restrict screenshot scale to CSS by @section9-lab in https://github.com/citrolabs/ego-lite/pull/328
- Add labeled pointer feedback and stabilize browser E2E by @section9-lab in https://github.com/citrolabs/ego-lite/pull/332
- fix(ego-browser): trust native frame provenance for snapshot refs by @section9-lab in https://github.com/citrolabs/ego-lite/pull/335
- feat(ego-browser): add Playwright-style download API by @section9-lab in https://github.com/citrolabs/ego-lite/pull/353
- Improve ego-browser runtime feedback and task receipts by @section9-lab in https://githu
- v1.2.32026-08-11 · 2026-08-11 04:47 UTC
查看更新说明
What's Changed
Other Changes
- test(ego-browser): migrate uncovered regression cases into real-browser e2e by @WUXM5 in https://github.com/citrolabs/ego-lite/pull/67
- Clarify task space tab closure by @section9-lab in https://github.com/citrolabs/ego-lite/pull/68
Full Changelog: https://github.com/citrolabs/ego-lite/compare/v1.2.3-beta.4...v1.2.3
- v1.2.3-beta.5pre-release2026-08-10 · 2026-08-10 08:41 UTC
查看更新说明
What's Changed
Other Changes
- test(ego-browser): migrate uncovered regression cases into real-browser e2e by @WUXM5 in https://github.com/citrolabs/ego-lite/pull/67
- Clarify task space tab closure by @section9-lab in https://github.com/citrolabs/ego-lite/pull/68
Full Changelog: https://github.com/citrolabs/ego-lite/compare/v1.2.3-beta.4...v1.2.3-beta.5
用户点评
登录用户的真实使用记录,可按版本和硬件筛选还没有人点评。第一个说出真实体验的人最有价值。
The fastest browser for AI agents to run web automation
ego (lite) is a browser where you and your AI agents work in parallel. Your agents run their browser tasks in their own Spaces, isolated workspaces inside the same browser, while you keep browsing in yours, so no agent ever takes the browser away from you. And the automation itself finishes faster, on fewer tokens.
Existing tools like browser-use and agent-browser are a bridge to the browser, not a browser of their own: they need a separate one to drive, your browser data rarely carries over intact, the connection is unstable, and you and the agent end up fighting over control of the browser. 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 and Windows, and Linux is on the roadmap.
1. Install
Pick whichever fits your flow.
1.1 Download the app
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. Try 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 (the page turned into structured text), acts on the page, and reports back, all while your own tabs stay untouched.
Your browsing data, cookies, and everything else the browser holds stay on your device. ego lite keeps its data collection deliberately narrow: simple product signals, like whether you've set ego lite as your default browser.
Highlights of ego lite
| Feature | What it does |
|---|---|
| Code-based, not CLI-based: faster runs on fewer tokens for 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 far faster, with higher task success rates, far fewer tool calls per task, and a much lower cost 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 customization inside the browser engine, ego lite produces the highest-quality page snapshots, the view text-only 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.
| Feature | ego lite | Browser extensionsClaude/Codex in Chrome | Built-in browsersClaude/ChatGPT built-in browser | Cloud browsersBrowserbase/Browser Use | Browser CLIsplaywright-cli/Browser Harness | AI browsersComet/Dia |
|---|---|---|---|---|---|---|
| Works with any AI agent | ✓ | — | — | ✓ | ✓ | — |
| Uses your browser logins | ✓ | ✓ | — | — | — | ✓ |
| Fewer CAPTCHAs | ✓ | ✓ | — | — | — | ✓ |
| Works across your whole computer | ✓ | — | ✓ | — | ✓ | — |
| Doesn't hijack your browser | ✓ | — | ✓ | ✓ | — | — |
| Parallel multitasking | ✓ | — | — | ✓ | — | — |
| Runs large scraping jobs | ✓ | — | — | ✓ | ✓ | — |
| Works as your daily browser | ✓ | ✓ | — | — | — | ✓ |
| Free | ✓ | — | — | — | ✓ | — |
| Data stored locally | ✓ | ✓ | ✓ | — | ✓ | — |
| Reusable skills (coming soon) | ✓ | — | — | — | — | — |
Benchmarks
Faster runs, higher success rates, fewer tokens. We ran ego-browser and four other browser tools for AI agents on Real-World Bench: 31 complex browser automation tasks on live websites. ego-browser leads on speed, success rate, and cost, and gets your agent through complex web tasks 47% to 63% faster than the other tools.
Every tool ran the same 31 tasks, driven by the same agent (pi) with the same model (gpt-5.6-sol, thinking effort max) and graded by the same judge against per-task rubrics. A task counts as a full success only when every requirement is met.
Docs
Tutorials, the full tool reference, and integration guides live at lite.ego.app/document/.
Community
- Discord, questions, setup help, and skill sharing
- GitHub Discussions, ideas and longer threads
- X/Twitter, updates and releases
Star History
License
The contents of this repository are released under the MIT License. The ego lite browser is a separate, free download.