{
  "markdown": "<img src=\"https://raw.githubusercontent.com/browser-use/media/main/browser-harness/banner-ink.svg\" alt=\"Browser Harness\" width=\"100%\" />\n\n# Browser Harness ♞\n\nConnect 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.\n\nTry 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.\n\n```\n  ● agent: wants to upload a file\n  │\n  ● agent-workspace/agent_helpers.py → helper missing\n  │\n  ● agent writes it                         agent_helpers.py\n  │                                                       + custom helper\n  ✓ file uploaded\n```\n\n**You will never use the browser again.**\n\n## See it work\n\n**Task:** \"Open my X profile, find my latest 20 video posts, and download them.\"\n\n[![Download my latest 20 X videos](docs/download-latest-20-x-videos.gif)](https://browser-use.com/showcase/videos/download-latest-20-x-videos.mp4)\n\n## Setup prompt\n\nPaste into Claude Code or Codex:\n\n```text\nInstall 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.\n```\n\nThe agent will open `chrome://inspect/#remote-debugging`. On first setup, tick\nthe checkbox so the agent can connect to your browser:\n\n<img src=\"docs/setup-remote-debugging.png\" alt=\"Remote debugging setup\" width=\"520\" style=\"border-radius: 12px;\" />\n\n## How it works\n\n- [`install.md`](install.md) connects the agent to your browser.\n- [`SKILL.md`](SKILL.md) teaches it the browser workflow.\n- [`src/browser_harness/`](src/browser_harness/) stays protected while the agent writes reusable helpers in its local workspace.\n\n## Scale with Browser Use Cloud\n\nUse 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).\n\n## MCP server\n\n`browser-harness-mcp` exposes the browser control helpers as MCP tools over\nstdio, so any MCP client (Claude Code, Devin, Cursor, etc.) can drive the\nbrowser without writing a second CDP layer. See [docs/MCP.md](docs/MCP.md) for\nsetup and client configuration.\n\n## Contributing\n\nBug fixes, documentation improvements, and agent-generated domain skills are welcome. See [CONTRIBUTING.md](CONTRIBUTING.md).\n\n---\n\n[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)\n",
  "bytes": 2929,
  "sha": "ee3cdce98e1163125222e61895228faeb188b100b61347369923be250105aab9",
  "repo_slug": "browser-use/browser-harness",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_browser_use_browser_harness_browser_harn_a661805e/readme"
}