browser-harness

Browser Harness connects an AI language model directly to your Chrome browser through a single protocol called Chrome DevTools Protocol (CDP). Instead of sitting between the AI and the browser with a rigid automation layer, this project acts as a thin bridge: the AI reads the page, decides what to do, and executes actions in your real browser rather than a sandboxed copy.

The key idea is that when the AI encounters a task it does not know how to complete (like uploading a file or navigating a site-specific flow), it writes the missing helper code itself and saves it. The next time a similar task comes up, the saved helper is reused. The README describes this as a self-healing system: the AI fills in the gaps during actual use, making the setup more capable over time without you writing code manually.

Setup is intentionally hands-off. You copy a short prompt into Claude Code or a similar AI coding tool, and the AI reads the project's install instructions and configures everything itself, including connecting to Chrome's remote debugging interface. You enable one checkbox in Chrome settings and click Allow when a popup appears.

The project is roughly 1,000 lines spread across four main pieces: an install guide, a usage guide, a protected core package, and a workspace folder where the AI writes and updates its own helper code. A folder of domain skills holds site-specific playbooks the AI builds for places like GitHub, LinkedIn, and Amazon. Community contributors can submit their AI-generated skill files via pull request.

Browser Use also offers a hosted cloud tier with free access to multiple concurrent browsers, proxy support, and CAPTCHA solving, for users who want to run tasks without keeping a local browser open.