{"repo":"browser-use/browser-harness","free":true,"listed":false,"github":"https://github.com/browser-use/browser-harness","clone":"git clone https://github.com/browser-use/browser-harness.git","description":"Browser Harness | Self-healing harness that enables LLMs to complete any task.","language":"Python","stars":16720,"topics":["ai-agent","browser-agent","browser-automation","browser-use","browser-use-box","browser-use-cloud","cdp","cloud-browser","llm","persistent-browser","playwright","telegram-agent","vps-agent","web-automation"],"license":"MIT","category":"ai_agent_tool","readme_excerpt":"<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## 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","default_branch":"main","files":179,"tree":[".claude-plugin/marketplace.json",".claude-plugin/plugin.json",".env.example",".github/ISSUE_TEMPLATE/bug-report.yml",".github/ISSUE_TEMPLATE/config.yml",".github/ISSUE_TEMPLATE/feature-request.yml",".github/VOUCHED.td",".github/workflows/release.yml",".gitignore","AGENTS.md","CLAUDE.md","CONTRIBUTING.md","LICENSE","README.md","SKILL.md","agent-workspace/agent_helpers.py","agent-workspace/domain-skills/BOSS-zhipin/chat.md","agent-workspace/domain-skills/BOSS-zhipin/job-search.md","agent-workspace/domain-skills/BOSS-zhipin/navigation.md","agent-workspace/domain-skills/aa/checkout.md","agent-workspace/domain-skills/agentlist/discovery.md","agent-workspace/domain-skills/alaska/checkout.md","agent-workspace/domain-skills/amazon/product-search.md","agent-workspace/domain-skills/archive-org/scraping.md","agent-workspace/domain-skills/articulate-rise/code-blocks.md","agent-workspace/domain-skills/arxiv-bulk/scraping.md","agent-workspace/domain-skills/arxiv/scraping.md","agent-workspace/domain-skills/atlas/overview.md","agent-workspace/domain-skills/bigbang-hr/checkout.md","agent-workspace/domain-skills/bilibili/navigation.md","agent-workspace/domain-skills/booking-com/scraping.md","agent-workspace/domain-skills/browser-use-cloud/cleanup-zombies.py","agent-workspace/domain-skills/browser-use-cloud/cloud.md","agent-workspace/domain-skills/capterra/scraping.md","agent-workspace/domain-skills/centilebrain/generate-estimates.md","agent-workspace/domain-skills/claude-ai/extract-share-transcript.py","agent-workspace/domain-skills/claude-ai/share-export.md","agent-workspace/domain-skills/coingecko/scraping.md","agent-workspace/domain-skills/coinmarketcap/scraping.md","agent-workspace/domain-skills/coursera/scraping.md","agent-workspace/domain-skills/craigslist/scraping.md","agent-workspace/domain-skills/crossref/scraping.md","agent-workspace/domain-skills/ctrip/hotels.md","agent-workspace/domain-skills/dev-to/scraping.md","agent-workspace/domain-skills/duckduckgo/scraping.md","agent-workspace/domain-skills/ebay/scraping.md","agent-workspace/domain-skills/etsy/scraping.md","agent-workspace/domain-skills/eventbrite/scraping.md","agent-workspace/domain-skills/expedia/automation.md","agent-workspace/domain-skills/facebook/groups.md","agent-workspace/domain-skills/facebook/pages.md","agent-workspace/domain-skills/flipkart/shopping.md","agent-workspace/domain-skills/framer/editor.md","agent-workspace/domain-skills/fred/scraping.md","agent-workspace/domain-skills/g2/scraping.md","agent-workspace/domain-skills/genius/scraping.md","agent-workspace/domain-skills/github/repo-actions.md","agent-workspace/domain-skills/github/scraping.md","agent-workspace/domain-skills/glassdoor/scraping.md","agent-workspace/domain-skills/gmail/compose.md","agent-workspace/domain-skills/goodreads/scraping.md","agent-workspace/domain-skills/gutenberg/scraping.md","agent-workspace/domain-skills/hackernews/scraping.md","agent-workspace/domain-skills/howlongtobeat/scraping.md","agent-workspace/domain-skills/hubspot/private-app-webhooks.md","agent-workspace/domain-skills/imdb/scraping.md","agent-workspace/domain-skills/itch-io/scraping.md","agent-workspace/domain-skills/job-boards/indeed-glassdoor.md","agent-workspace/domain-skills/letterboxd/scraping.md","agent-workspace/domain-skills/linkedin/invitation-manager.md","agent-workspace/domain-skills/loom/folder-enumeration.md","agent-workspace/domain-skills/ly-com/hotels.md","agent-workspace/domain-skills/macrotrends/scraping.md","agent-workspace/domain-skills/manus/tasks.md","agent-workspace/domain-skills/medium/article-hydration.md","agent-workspace/domain-skills/medium/scraping.md","agent-workspace/domain-skills/metacritic/scraping.md","agent-workspace/domain-skills/musicbrainz/scraping.md","agent-workspace/domain-skills/nasa/scraping.md","agent-workspace/domain-skills/news-aggregation/multi-source.md","agent-workspace/domain-skills/open-library/scraping.md","agent-workspace/domain-skills/openalex/scraping.md","agent-workspace/domain-skills/openstreetmap/scraping.md","agent-workspace/domain-skills/package-registries/npm-pypi.md","agent-workspace/domain-skills/perplexity/computer.md","agent-workspace/domain-skills/polymarket/scraping.md","agent-workspace/domain-skills/producthunt/scraping.md","agent-workspace/domain-skills/pubmed/scraping.md","agent-workspace/domain-skills/qbo/report-export.md","agent-workspace/domain-skills/quora/scraping.md","agent-workspace/domain-skills/rawg/scraping.md","agent-workspace/domain-skills/reddit/scraping.md","agent-workspace/domain-skills/rest-countries/scraping.md","agent-workspace/domain-skills/salesforce/.gitkeep","agent-workspace/domain-skills/sec-edgar/scraping.md","agent-workspace/domain-skills/shopify-admin/README.md","agent-workspace/domain-skills/shopify-admin/embedded-apps.md","agent-workspace/domain-skills/shopify-admin/knowledge-base.md","agent-workspace/domain-skills/shopify-admin/polaris-inputs.md","agent-workspace/domain-skills/soundcloud/scraping.md","agent-workspace/domain-skills/spotify/scraping.md","agent-workspace/domain-skills/spreadshirt/.gitkeep","agent-workspace/domain-skills/stackoverflow/scraping.md","agent-workspace/domain-skills/steam/scraping.md","agent-workspace/domain-skills/substack/scraping.md","agent-workspace/domain-skills/tasksquad-ai/agents.md","agent-workspace/domain-skills/tasksquad-ai/auth.md","agent-workspace/domain-skills/tasksquad-ai/tasks.md","agent-workspace/domain-skills/thetechgeeks/pricing.md","agent-workspace/domain-skills/tiktok/upload.md","agent-workspace/domain-skills/tradingview/scraping.md","agent-workspace/domain-skills/trello/boards-and-lists.md","agent-workspace/domain-skills/trustpilot/scraping.md","agent-workspace/domain-skills/vercel/vercel.md","agent-workspace/domain-skills/walmart/scraping.md","agent-workspace/domain-skills/wayback-machine/scraping.md","agent-workspace/domain-skills/weather/scraping.md","agent-workspace/domain-skills/wehotel/hotels.md","agent-workspace/domain-skills/wellfound/scraping.md","agent-workspace/domain-skills/weread/read.md","agent-workspace/domain-skills/world-bank/scraping.md","agent-workspace/domain-skills/x/posting.md","agent-workspace/domain-skills/xiaohongshu/scraping.md","agent-workspace/domain-skills/youtube/scraping.md","agent-workspace/domain-skills/zillow/scraping.md","browser-harness","docs/allow-remote-debugging.png","docs/download-latest-20-x-videos.gif","docs/setup-remote-debugging.png","docs/snap-linux-headless.md","install.md","interaction-skills/connection.md","interaction-skills/cookies.md","interaction-skills/cross-origin-iframes.md","interaction-skills/dialogs.md","interaction-skills/downloads.md","interaction-skills/drag-and-drop.md","interaction-skills/dropdowns.md","interaction-skills/iframes.md","interaction-skills/make-video.md","interaction-skills/network-requests.md","interaction-skills/print-as-pdf.md","interaction-skills/profile-sync.md","interaction-skills/screenshots.md","interaction-skills/scrolling.md","interaction-skills/shadow-dom.md","interaction-skills/tabs.md","interaction-skills/uploads.md","interaction-skills/viewport.md","pyproject.toml","skills/browser-harness/SKILL.md","skills/browser-harness/references/install.md","src/browser_harness/SKILL.md","src/browser_harness/__init__.py","src/browser_harness/_ipc.py","src/browser_harness/admin.py","src/browser_harness/auth.py","src/browser_harness/daemon.py","src/browser_harness/helpers.py","src/browser_harness/macos.py","src/browser_harness/paths.py","src/browser_harness/recorder.py","src/browser_harness/run.py","src/browser_harness/telemetry.py","src/browser_harness/video-template.html","src/browser_harness/video.py","src/browser_harness/video_render.py","tests/__init__.py","tests/conftest.py","tests/integration/__init__.py","tests/integration/test_js.py","tests/unit/__init__.py","tests/unit/test_admin.py","tests/unit/test_daemon.py","tests/unit/test_helpers.py","tests/unit/test_ipc.py","tests/unit/test_macos.py","tests/unit/test_run.py","tests/unit/test_skill.py"],"storefront":"/r/browser-use","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/browser-use/browser-harness/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}