browser-harness
Open-source browser agent driven via CDP — direct browser control, 79K stars, YC W25. browser-harness gives Claude Code direct, low-level co
Open source Repository Open in the app JSON README (API)
About
Open-source browser agent driven via CDP — direct browser control, 79K stars, YC W25. browser-harness gives Claude Code direct, low-level control of a real Chrome browser via the Chrome DevTools Protocol. Coordinate-level clicks pass through iframes, shadow DOM, and cross-origin frames at the compositor level — no selector hunting, no Playwright wrappers. Connects to a long-running Browser Use Cloud or local browser session, so logins persist across runs. Highlights: - Screenshot-first workflow: capture → read pixel → click_at_xy → re-capture to verify - Bulk HTTP fetch helper for static pages (no browser overhead) - Raw CDP escape hatch for anything helpers don’t cover - Interaction skills for dialogs, dropdowns, iframes, shadow DOM, file uploads, cross-origin frames - Remote browsers via Browser Use Cloud — share a live URL with a human when login/CAPTCHA blocks the agent
Details
- Kind
- Plugins
- Topic
- Web search, scraping & browser
- Publisher
- browser-use
- Origin
- marketplace
- Category
- ferramentas
- Stars
- 17,456
- Forks
- 1,706
- Open pull requests
- 296
- Last push
- 2026-09-07T20:13:31Z
- Repository state
- ativo
- Language
- Python
- License
- MIT
- Added
- 2026-08-30 01:48:58
- Updated
- 2026-08-30 01:48:58
- Origin id
browser-use/browser-harness/browser-harness
README
<img src="https://raw.githubusercontent.com/browser-use/media/main/browser-harness/banner-ink.svg" alt="Browser Harness" width="100%" /> # Browser Harness ♞ Connect an LLM directly to your real browser through one editable CDP websocket. The agent writes missing helpers as it works, so the harness improves with every task. Try browser-harness in [Browser Use Cloud](https://cloud.browser-use.com/v4?utm_campaign=browser-harness-use-in-cloud&utm_source=github) 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." [](https://browser-use.com/showcase/videos/download-latest-20-x-videos.mp4) ## Setup prompt Paste into Claude Code or Codex: ```text Install or upgrade browser-harness to the latest stable version with uv using Python 3.12, register the skill from `browser-harness skill`, and connect it to my browser. Ask whether I want local browser recordings enabled; default to no and preserve my existing preference on upgrades. Follow https://github.com/browser-use/browser-harness/blob/main/install.md if setup or connection fails. ``` The agent will open `chrome://inspect/#remote-debugging`. On first setup, tick the checkbox so the agent can connect to your browser: <img src="docs/setup-remote-debugging.png" alt="Remote debugging setup" width="520" style="border-radius: 12px;" /> ## How it works - [`install.md`](install.md) connects the agent to your browser. - [`SKILL.md`](SKILL.md) teaches it the browser workflow. - [`src/browser_harness/`](src/browser_harness/) stays protected while the agent writes reusable helpers in its local workspace. ## Scale with Browser Use Cloud Use your local browser for logged-in, personal work. When you want many browsers in parallel—with live previews, proxies, stealth, CAPTCHA solving, and more—scale with [Browser Use Cloud](https://cloud.browser-use.com/new-api-key). ## MCP server `browser-harness-mcp` exposes the browser control helpers as MCP tools over stdio, so any MCP client (Claude Code, Devin, Cursor, etc.) can drive the browser without writing a second CDP layer. See [docs/MCP.md](docs/MCP.md) for setup and client configuration. ## Contributing Bug fixes, documentation improvements, and agent-generated domain skills are welcome. See [CONTRIBUTING.md](CONTRIBUTING.md). --- [The Bitter Lesson of Agent Harnesses](https://browser-use.com/posts/bitter-lesson-agent-harnesses) · [Web Agents That Actually Learn](https://browser-use.com/posts/web-agents-that-actually-learn)