Skip to content
Back to search

evoui-browser

Self-evolving browser automation for Codex, Claude Code, and Cursor—learn reusable site knowledge and safely replay verified routines with agent-browser.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/salmonbird--evoui-browser/badge.svg)](/listings/salmonbird--evoui-browser)

HTML

<a href="/listings/salmonbird--evoui-browser"><img src="/api/listings/salmonbird--evoui-browser/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Requirements: macOS or Linux, Python 3.10 or newer, and Node.js 24 or newer with npm. Evoui adds no third-party Python packages. Windows is not currently supported because Evoui uses POSIX `fcntl`.

Install the Skill and its pinned browser runtime:

npx skills add Salmonbird/evoui-browser --skill evoui-browser -g
npm install -g agent-browser@0.33.1
agent-browser install

On Linux, use `agent-browser install --with-deps` if browser libraries are missing. The `skills` CLI may ask which detected agents should receive the Skill; choose the Codex, Claude Code, or Cursor hosts you use, then start a new agent session. Some compatible agents share the CLI's global Skill directory, so Evoui may also appear in other detected agents; only the three hosts named above are supported.

> [!NOTE] > The third-party `skills` CLI collects anonymous usage telemetry for confirmed > public skills. Set `DISABLE_TELEMETRY=1` before the `npx` command to opt out.

Then give the agent a concrete website and goal:

Use $evoui-browser to open <website> and complete <task>.   # Codex
Use /evoui-browser to open <website> and complete <task>.   # Claude Code / Cursor

Prefer assisted setup? Send your agent this prompt:

Install Evoui Browser from https://github.com/Salmonbird/evoui-browser.
Use the README's Quick start, make it available to the supported host I am using,
keep agent-browser pinned to 0.33.1, and tell me when I can start a new session
and invoke the Skill.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 171 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <p align="center">
  2. <img src="assets/readme/evoui-browser-hero.svg" alt="Evoui Browser — reuse verified browser steps" width="100%">
  3. </p>
  4. <p align="center"><strong>Less repeated browser work. The agent keeps the judgment.</strong></p>
  5. <p align="center">
  6. <strong>English</strong> · <a href="README.zh-CN.md">简体中文</a>
  7. </p>
  8. <p align="center">
  9. <a href="https://github.com/Salmonbird/evoui-browser/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/Salmonbird/evoui-browser/ci.yml?branch=main&label=CI&style=flat-square" alt="CI status"></a>
  10. <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache--2.0-566878?style=flat-square" alt="Apache 2.0 license"></a>
  11. <img src="https://img.shields.io/badge/status-experimental-C4553D?style=flat-square" alt="Experimental status">
  12. </p>
  13. Evoui Browser is an optional Agent Skill for
  14. [`agent-browser`](https://github.com/vercel-labs/agent-browser). Run a browser
  15. task normally once; on later, similar tasks, Evoui can reuse verified navigation
  16. and mechanical steps so the agent spends less time exploring and repeating
  17. work. The host agent still chooses targets, interprets results, and decides what
  18. to do next. The currently supported hosts are Codex, Claude Code, and Cursor.
  19. > [!WARNING]
  20. > Evoui Browser is experimental. Start with non-critical tasks on non-sensitive websites.
  21. ## See the difference
  22. <p align="center"><a href="https://github.com/user-attachments/assets/52810aa1-aa68-4f8d-b672-987961ffbc31"><strong>▶ Watch the 71-second invoice-review demo</strong></a></p>
  23. The first run explores the site step by step. On the next run, Evoui reuses the
  24. matching navigation and review routine while the agent still decides which
  25. invoices need attention. That avoids rediscovering the same invoice page and
  26. controls on every run.
  27. Evoui does **not** promise that every task will be faster. It helps when a site
  28. and task contain repeatable work that can be verified. A first run may take the
  29. same amount of work—or more—because it also gathers evidence for possible reuse.
  30. ## Quick start
  31. Requirements: macOS or Linux, Python 3.10 or newer, and Node.js 24 or newer with
  32. npm. Evoui adds no third-party Python packages. Windows is not currently
  33. supported because Evoui uses POSIX `fcntl`.
  34. Install the Skill and its pinned browser runtime:
  35. ```bash
  36. npx skills add Salmonbird/evoui-browser --skill evoui-browser -g
  37. npm install -g agent-browser@0.33.1
  38. agent-browser install
  39. ```
  40. On Linux, use `agent-browser install --with-deps` if browser libraries are
  41. missing. The `skills` CLI may ask which detected agents should receive the
  42. Skill; choose the Codex, Claude Code, or Cursor hosts you use, then start a new
  43. agent session. Some compatible agents share the CLI's global Skill directory,
  44. so Evoui may also appear in other detected agents; only the three hosts named
  45. above are supported.
  46. > [!NOTE]
  47. > The third-party `skills` CLI collects anonymous usage telemetry for confirmed
  48. > public skills. Set `DISABLE_TELEMETRY=1` before the `npx` command to opt out.
  49. Then give the agent a concrete website and goal:
  50. ```text
  51. Use $evoui-browser to open <website> and complete <task>. # Codex
  52. Use /evoui-browser to open <website> and complete <task>. # Claude Code / Cursor
  53. ```
  54. Prefer assisted setup? Send your agent this prompt:
  55. ```text
  56. Install Evoui Browser from https://github.com/Salmonbird/evoui-browser.
  57. Use the README's Quick start, make it available to the supported host I am using,
  58. keep agent-browser pinned to 0.33.1, and tell me when I can start a new session
  59. and invoke the Skill.
  60. ```
  61. ## How it helps
  62. 1. **Run normally.** The agent completes the task with `agent-browser` while
  63. Evoui records evidence from the managed calls.
  64. 2. **Learn selectively.** Evoui keeps only navigation or routines with a clear
  65. future use and enough evidence. A successful task does not have to produce
  66. knowledge.
  67. 3. **Reuse when the page still matches.** On a later task, Evoui verifies fresh
  68. page state and reuses only the applicable mechanical steps.
  69. <p align="center">
  70. <img src="assets/readme/how-it-works.svg" alt="Run normally, learn selectively, and reuse verified steps only when the current page matches" width="100%">
  71. </p>
  72. ## Safety boundaries
  73. - Evoui replays mechanical browser work, not business judgment.
  74. - A page mismatch, missing target, failed postcondition, or unknown outcome
  75. returns control to the agent.
  76. - A click, submission, or other mutation that may already have taken effect is
  77. not blindly retried.
  78. - Login, CAPTCHA, permission, and confirmation steps pause for you in the same
  79. visible browser window.
  80. - One-off tasks and operations with a reliable API or dedicated connector should
  81. use the simpler direct path.
  82. ## Local data and privacy
  83. Evoui stores browser profiles, temporary Run evidence, and learned knowledge in
  84. `~/.evoui/` by default. Managed evidence may temporarily include command
  85. arguments, non-empty stdin, page text, form input, or site-returned data. Normal
  86. terminal cleanup deletes the content-bearing Run trace after the task and any
  87. selected learning work finish; an interruption or cleanup failure may leave data
  88. on disk.
  89. Cleanup reduces retained data. It is **not** redaction, encryption, credential
  90. protection, or a privacy boundary. Debug tracing retains additional data without
  91. automatic rotation. See [`SECURITY.md`](SECURITY.md) for the full boundary, and
  92. never attach credentials, cookies, browser profiles, or task traces to a public
  93. issue.
  94. By default, the selected Session and visible browser window remain open after a
  95. task for reuse, including their login state. Ask the agent to close the Session
  96. when you no longer want it running.
  97. ## Update or remove
  98. For a CLI-managed installation, update by running the install command again
  99. with the supported hosts you use. For example, to update Codex:
  100. ```bash
  101. npx skills add Salmonbird/evoui-browser --skill evoui-browser -g -a codex
  102. ```
  103. Use `-a claude-code` or `-a cursor` instead, or repeat `-a` for multiple
  104. supported hosts.
  105. Existing clone-and-symlink installations continue to update directly:
  106. ```bash
  107. git -C ~/src/evoui-browser pull --ff-only
  108. ```
  109. After either update method, start a new agent session.
  110. To remove the global CLI-managed installation from all hosts:
  111. ```bash
  112. npx skills remove evoui-browser -g
  113. ```
  114. Removing the Skill does not delete `~/.evoui/` or the separately installed
  115. `agent-browser` runtime. Inspect local state before deleting it.
  116. If installation fails, first check `agent-browser --version`. Use
  117. `agent-browser doctor` only to diagnose a browser or daemon startup problem; it
  118. performs active checks and may clean stale daemon state.
  119. ## Contributing
  120. Small fixes, docs, tests, reproducible cases, and focused pull requests are
  121. welcome. The two local validation commands and the few changes worth discussing
  122. first are in [`CONTRIBUTING.md`](CONTRIBUTING.md). To inspect or modify Evoui,
  123. clone the repository rather than relying only on the CLI-managed installation.
  124. ## License and attribution
  125. Evoui Browser is licensed under the [Apache License 2.0](LICENSE). Third-party
  126. notices are in [NOTICE](NOTICE). Modified documentation derived from
  127. `agent-browser` retains a separate
  128. [upstream license copy](skills/evoui-browser/references/agent-browser/LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.