Browser Harness review
Browser Harness is an open-source Python tool that lets Claude Code, Codex or Cursor control your real Chrome browser, logged in as you.
TL;DR
Browser Harness connects coding agents like Claude Code, Codex and Cursor to your running Chrome over the DevTools Protocol. It suits developers who want agents to act on sites where they are already signed in. When a helper is missing, the agent writes it and keeps it for later tasks, so there is no fixed tool list.
- 18.8kGitHub stars
- +203new stars, week of Oct 25
- 3.3Mdownloads a week, +62% vs 4-week avg
- #4in Browser and computer use this week
Browser Harness at a glance
- Category
- Browser and computer use
- Maintained by
- Browser Use (organization, @browser-use on GitHub)
- License
- MIT
- Language
- Python, HTML, Shell
- Repository
- github.com/browser-use/browser-harness
- Website
- browser-harness.com
- PyPI package
- browser-harness 0.1.13
- Latest release
- v0.1.13 on GitHub, Sep 4, 2026
- First published
- Apr 17, 2026
What Browser Harness does
- Browser Harness lets an agent open pages, click, type, fill forms, read the screen, and download and upload files in your Chrome.
- Browser Harness works in your existing Chrome, with your tabs, cookies and logins.
- Browser Harness lets the agent write missing helpers in its local workspace and reuse them on later tasks.
- Browser Harness includes browser-harness-mcp, which exposes its browser control helpers as MCP tools over stdio for any MCP client.
- Browser Harness marks the controlled tab with a π΄ in its title and works in the background, so the tab you are viewing stays yours.
- Browser Harness launches a Chromium-family browser if none is running, picking a profile that already has remote debugging enabled.
How it works
Browser Harness is set up by pasting a setup prompt into your coding agent. The agent installs it with uv and Python 3.12, registers the skill, and connects to Chrome over the DevTools Protocol. The install.md file handles the connection, and SKILL.md teaches the browser workflow. The core package stays protected while the agent writes reusable helpers in its workspace. Cursor connects through an MCP config.
How to install and start using Browser Harness
From PyPI
pip install browser-harnessRequirements
- Python 3.11 or later. The setup prompt uses Python 3.12.
- uv, for installation and the Cursor MCP configuration.
- Chrome or another Chromium-family browser with remote debugging enabled. On Chrome 144+, you also click Allow.
- A coding agent that can run shell commands, or an MCP client.
First steps
- Paste the setup prompt from the README into Claude Code or Codex. Cursor users add the MCP config to .cursor/mcp.json instead.
- Choose whether to enable local browser recordings when the agent asks. The default is no.
- When the agent opens chrome://inspect/#remote-debugging, tick the checkbox on first setup so it can connect to your browser.
- Ask the agent for a task in plain words, such as downloading your latest 20 X videos.
Who Browser Harness is for
- Developers who want a coding agent to work on sites where they are already logged in.
- Users of Claude Code, Codex, Cursor, Gemini CLI, Hermes Agent or OpenClaw.
- Personal web tasks like downloading files, filling forms or reading pages in your own browser.
Limitations to know
- Browser Harness gets whole-browser access through remote debugging, not per-site or per-tab approval.
- The README recommends Playwright instead for isolated, repeatable CI tests of your own app in a clean browser.
- The README recommends Chrome DevTools MCP instead for performance traces and DevTools debugging.
- Running many browsers in parallel, or while your laptop is closed, requires Browser Use Cloud, which costs $0.02 per browser-hour.
Is Browser Harness growing? Usage data
In the week of Oct 25β31, 2026, Browser Harness ranked #49 on the Devtoolwatch Board and #4 in Browser and computer use, with a momentum score of 76 out of 100. Its main package had 3.3M downloads that week, +62% against its own 4-week average.
Show the weekly numbers
| Week of | New stars |
|---|---|
| Aug 9, 2026 | 132 |
| Aug 16, 2026 | 329 |
| Aug 23, 2026 | 214 |
| Aug 30, 2026 | 173 |
| Sep 6, 2026 | 129 |
| Sep 13, 2026 | 291 |
| Sep 20, 2026 | 351 |
| Sep 27, 2026 | 162 |
| Oct 4, 2026 | 120 |
| Oct 11, 2026 | 109 |
| Oct 18, 2026 | 148 |
| Oct 25, 2026 | 203 |
On Hacker News
- Show HN: Browser Harness β Gives LLM freedom to complete any browser task, 134 points and 66 comments (Apr 24, 2026)
The Board ranks tools by four signals each week: new stars, new stars for the repo's size, added downloads and download growth beyond the market. How the ranking works.
Browser Harness alternatives
Other browser and computer-use agents on the Board in the week of Oct 25β31, 2026, by momentum:
| Rank | Tool | Stars | Downloads/wk |
|---|---|---|---|
| #1 | ego liteego lite is a Chromium-based browser that lets AI agents like Claude Code or Codex run browser automation using your logged-in browserβ¦ | 21k | β |
| #2 | MoliMoli is an open-source headless browser for AI agents, built in Rust, that fetches, extracts, and automates web pages through CLI, CDP,β¦ | 21.9k | β |
| #3 | CuaCua is open-source infrastructure that gives AI agents full desktops, with desktop automation drivers, local VMs, sandboxes, andβ¦ | 31.4k | β |
| #5 | Jev UltrafastJev Ultrafast is an open-source Python browser agent that picks an operation and an indexed page element per step, using TypeSafe's Jev. | 24k | β |
| #6 | StagehandStagehand is an SDK for building browser agents that automate and extract data from websites using natural language, in TypeScript,β¦ | 25.9k | 3M |
| #7 | Steel BrowserSteel Browser is an open-source browser API and sandbox that lets AI agents and apps automate the web through managed Chrome sessions. | 7.9k | 158.7k |
Recent Browser Harness releases
Browser Harness FAQ
Is Browser Harness free and open source?
Yes. Browser Harness's source code is on GitHub (browser-use/browser-harness) under the MIT license, so you can use it for free. Its website also links to a pricing page (https://browser-harness.com/pricing) for any paid plans.
How do I install Browser Harness?
Run pip install browser-harness. The browser-harness package needs Python 3.11 or newer.
Is Browser Harness still maintained?
Yes. The browser-use/browser-harness repository was last updated on Oct 17, 2026, and the latest release, v0.1.13 on GitHub, came out on Sep 4, 2026.
How popular is Browser Harness?
Browser Harness has 18.8k GitHub stars as of Nov 1, 2026. It gained 203 new stars in the week of Oct 25β31, 2026, against a 12-week average of 197 a week. Its main package had 3.3M downloads that week, +62% against its own 4-week average. That made it #4 among browser and computer-use agents on the Devtoolwatch Board.
Browser Harness vs Browser Use: how do they compare?
Browser Harness and Browser Use are both tracked by Devtoolwatch as browser and computer-use agents. Browser Harness has 18.8k GitHub stars and Browser Use has 119.7k. In the week of Oct 25β31, 2026, Browser Harness's main package had 3.3M downloads and Browser Use's had 1.5M. Browser Use review.
What are the best alternatives to Browser Harness?
Other browser and computer-use agents on the Devtoolwatch Board in the week of Oct 25β31, 2026, by momentum: ego lite (#1), Moli (#2), Cua (#3), Jev Ultrafast (#5), Stagehand (#6). The alternatives table above has their numbers.
What is Browser Harness?
Browser Harness is an open-source, MIT-licensed tool from Browser Use. It lets coding agents such as Claude Code, Codex and Cursor control your real Chrome over the DevTools Protocol, logged in as you.
What is the difference between Browser Harness and the Browser Use CLI?
Browser Harness and the Browser Use CLI share the same engine. The Browser Use CLI, the browser-use command, is built on Browser Harness and ships with the rest of Browser Use. Browser Harness is the standalone open-source repo. Either one gives your agent your browser.
Does Browser Harness use my real browser?
Yes. Browser Harness works in the Chrome you already use, with your tabs, cookies and logins. Chrome asks once for permission.
How do I know which tab Browser Harness is using?
Browser Harness puts a π΄ at the start of the controlled tab's title. It works in the background, so the tab you are looking at stays yours.
Which agents work with Browser Harness?
Browser Harness works with Claude Code, Codex, Cursor, Gemini CLI, Hermes Agent, OpenClaw, and anything that can run a shell command. Any MCP client can also use it through browser-harness-mcp.
Sources
- browser-use/browser-harness on GitHub
- Browser Harness README
- browser-harness on PyPI
- Browser Harness website
- Release v0.1.13 (Sep 4, 2026)
- Release v0.1.12 (Sep 4, 2026)
- Release v0.1.11 (Sep 3, 2026)
- Hacker News: Show HN: Browser Harness β Gives LLM freedom to complete any browser task
- Devtoolwatch Board, the week of Oct 25β31, 2026
Browser Harness README badge
Maintainers can show the tool's weekly Board rank in their README:
[](https://index.devtoolwatch.com/tools/browser-use-browser-harness/)How this page is made: Devtoolwatch writes each review from the project's README, releases, package metadata and website, with an AI model, then checks every claim against the source it cites and drops what the sources don't support. The numbers come from Devtoolwatch's daily GitHub snapshots, GitHub's stargazer history, and the npm and PyPI download APIs. Spotted an error? Email [email protected].