Verified project record

browser-use/browser-harness

browser-harness connects an LLM directly to a real Chrome or Chromium browser via a single websocket, using a thin CDP layer to execute web tasks. During execution it dynamically writes missing Python helper code to self-heal and fix functionality gaps.

Project overview

By dynamically writing its own missing helper code during execution, browser-harness introduces a self-improving approach to browser automation that adapts where rigid automation scripts fail.

Project type: AI Agent
Use cases: Automation
Deployment: Refer to project documentation
License: MIT

Best for

Developers and AI engineers who need an LLM-driven agent to interact with live web pages and dynamically adapt to missing functionality.

Key capabilities

Connects to a real running Chrome or Chromium browser via a single websocket for direct task execution.
Provides a command to register the browser-harness skill so it connects to the browser.

Limitations and risks

During execution, the agent writes and edits Python helper code dynamically to fix missing functionality, which requires appropriate review and operational guardrails before production deployment.

Getting started

Install or upgrade browser-harness with uv using Python 3.12, configure Chrome remote debugging settings, and run the browser-harness command to register the skill. An LLM agent is required to interpret and execute the setup instructions.

Evidence and sources

README: Connect an LLM directly to your real browser with a thin, editable CDP harness. For browser tasks where you need **complete freedom**. One websocket to Chrome, nothing between. Th…
Release: v0.1.7
README: 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`…
README: Plain `browser-harness` helper calls attach to the running Chrome/Chromium CDP endpoint. For isolated automation, launch Chrome yourself with `--remote-debugging-port` and pass `B…
README: - `install.md` — first-time install and browser bootstrap - `SKILL.md` — day-to-day usage - `src/browser_harness/` — protected core package - `${XDG_CONFIG_HOME:-~/.config}/browse…

Reviewed at: 2026-07-22T05:13:48Z