browser-use /browser-harness
Let Claude Code, Codex or Cursor use your real Chrome, logged in as you. One prompt to set up. Open source, MIT.
★ 19,091⑂ 1,894👁 50⑃ 900● 110▤ 14
More from this author
+11
Daily
19,091
stars
1,894
forks
50
watchers
900
prs
110
issues
14
releases
README
[!NOTE]
Browser Harness is now the engine inside Browser Use. Use the browser-use CLI: same helpers and daemon, plus browser-use login, an MCP server (browser-use --cli-mcp) and browser-use skill install.
bash
uv tool install browser-use
browser-use new_tab("https://example.com")
print(page_info())
PY
The browser-harness command keeps working. Domain skills and interaction skills stay in this repo.
Browser Harness ♞
Browser Harness lets Claude Code, Codex or Cursor use your real Chrome browser: open pages, click, type, read and download, logged in as you. Paste one prompt into your coding agent to set it up. It talks to Chrome over the DevTools Protocol (CDP), and the agent writes any missing helper as it works, so the harness gets better with each task. Open source, MIT licensed.
Try browser-harness in Browser Use Cloud or paste the setup prompt into your coding agent.
● agent: wants to upload a file
│
● agent-workspace/agent_helpers.py → helper missing
│
● agent writes it agent_helpers.py
│ + custom helper
✓ file uploaded
You will never use the browser again.
See it work
Task: "Open my X profile, find my latest 20 video posts, and download them."
Setup prompt
Paste into Claude Code or Codex (Cursor: use the MCP config below):
text
Install browser-use with uv tool install browser-use, run browser-use skill install to register the skill, and connect it to my browser. If setup or connection fails, run browser-use --doctor and follow its output and the error message.
The agent will open chrome://inspect/remote-debugging. On first setup, tick
the checkbox so the agent can connect to your browser:
How it works
- install.md connects the agent to your browser.
- SKILL.md teaches it the browser workflow.
- src/browser_harness/ stays protected while the agent writes reusable helpers in its local workspace.
Compared with other browser tools
| | Works with | Browser it drives | What you approve in your own Chrome |
|---|---|---|---|
| Browser Harness | Claude Code, Codex, Cursor, any MCP client via browser-harness-mcp | Your running Chrome, logged in as you | Whole browser: on Chrome 144+, tick remote debugging in chrome://inspect, then click Allow |
| Playwright MCP | Any MCP client (Claude Code, Codex, Cursor, Copilot and more) | Its own browser profile by default. Your Chrome with --extension (Playwright Extension) or --cdp-endpoint | Chosen tabs (one tab group per client) via the extension, approval skippable with a token; or whole browser via --cdp-endpoint |
| Playwright CLI | Claude Code, GitHub Copilot and other agents that run shell commands | Its own browser by default. Your Chrome with attach --extension=chrome or attach --cdp=chrome | Chosen tab via the Playwright Extension, or whole browser via --cdp |
| Chrome DevTools MCP | Any MCP client (Claude Code, Cursor, Copilot, Antigravity and more), plus a CLI | A new ChTop issues
#191Setup challenges: Snap confinement and environment-specific blockers6 comments · 2026-04-24#786Cold-start auto-launch fails: daemon exits before the chrome-not-running rescue branch can fire4 comments · 2026-09-10#882capture_screenshot hangs ~40% of the time on headless tabs (visibilityState "hidden"); activate_tab first fixes it3 comments · 2026-10-04#879helpers: CDP attach lost after goto_url in the same run — capture_screenshot fails with 'Not attached to an active page'3 comments · 2026-10-02#716uv-present-but-not-uv-managed installs still get a raw uv tool upgrade error3 comments · 2026-09-01#681Telemetry uploads the user's script, stdout, and every helper argument — the redaction filter is applied to the wrong code path3 comments · 2026-08-29#148Cannot submit Ember.js modal forms — framework ignores all programmatic input3 comments · 2026-04-22#934Domain skills: 58 review findings in example code (and 3 files to fix before republishing)2 comments · 2026-10-23
Discussions
#575Panerelay 0.4.0: use Browser Use with an existing Chrome session0 comments · 2026-08-03#449How to avoid 'allow' prompts?0 comments · 2026-06-15#360Browser Use Box: run Browser Harness on your own always-on box1 comments · 2026-05-15#355Dgx Spark ( headless )0 comments · 2026-05-14#327High CPU usage only when using browser-harness via CDP0 comments · 2026-05-09
Latest release
v0.1.13 v0.1.13 2026-09-04What changed - Pin the MCP extra to mcp 2.1.1. - Pin release build tooling to build 1.6.0 and setuptools 84.0.0. - Preserve the Chrome permission and macOS accessibility reliability improvements from 0.1.12. Verification - 251 unit tests passed with the MCP extra. - pip-audit found no known vulnerabilities in the resolved environment. - Wheel and source distribution built successfully.