Verified project record

browser-use/browser-harness

browser-harness lets coding agents such as Claude Code, Codex or Cursor drive the user's real, logged-in Chrome browser to open pages, click, type, read and download over the DevTools Protocol. It sets up with one prompt and the agent writes reusable browser helpers into its local workspace as it works.

Project overview

Rather than running a fresh automated browser, it gives agents direct control of the user's real logged-in Chrome, exposed as MCP tools so any MCP client can reuse the same browser helpers.

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

Best for

Developers who want Claude Code, Codex or Cursor to perform browser tasks in their real, logged-in Chrome without writing a browser-automation layer themselves.

Key capabilities

Lets Claude Code, Codex or Cursor use the user's real Chrome browser to open pages, click, type, read and download, logged in as them, talking to Chrome over the DevTools Protocol.
The agent writes missing helpers into its local workspace as it works, so the harness improves with each task while the core package stays protected.
Exposes the browser control helpers as MCP tools over stdio so any MCP client can drive the browser without writing a second CDP layer.

Limitations and risks

The agent operates the user's real browser logged in as them, so any browsing it performs happens under the user's own sessions and accounts. Consider this before granting an agent access.

Getting started

Paste the setup prompt into Claude Code or Codex; the agent installs browser-harness via uv with Python 3.12 and registers the skill, then you tick the remote debugging checkbox in chrome://inspect/#remote-debugging. No coding is required, and the interaction is through the CLI.

Evidence and sources

Release: v0.1.13
README: Browser Harness lets Claude Code, Codex or Cursor use your real Chrome browser: open pages, click, type, read and download, logged in as you.
README: "Open my X profile, find my latest 20 video posts, and download them."
README: 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.
README: stays protected while the agent writes reusable helpers in its local workspace

Source updated at: 2026-10-15T19:51:01Z

Open original GitHub project