browser-harness

Let Claude Code, Codex or Cursor use your real Chrome, logged in as you. One prompt to set up. Open source, MIT.

What is browser-harness?

Let Claude Code, Codex or Cursor use your real Chrome, logged in as you. One prompt to set up. Open source, MIT.

Overview of browser-harness

What it is

Browser Harness is an open-source tool that lets coding agents such as Claude Code, Codex, or Cursor control your real Chrome browser. It connects to Chrome over the DevTools Protocol (CDP) and allows the agent to open pages, click, type, read, and download files while you remain logged into your accounts. The agent writes any missing helper functions as it works, so the harness improves with each task.

Key features

  • Uses your real Chrome browser, logged in as you, via the DevTools Protocol (CDP).
  • One-prompt setup for Claude Code, Codex, or Cursor.
  • Agent writes missing helpers automatically, improving the harness over time.
  • Open source under the MIT license.
  • MCP server (browser-harness-mcp) available for any MCP client.
  • In an evaluation on 100 BU Bench V2.1 tasks, it had the lowest median input tokens (2.1M) and lowest median model cost ($0.042) among compared tools.

Use cases

  • Personal browser automation with coding agents while logged into your accounts, using your own Chrome with all extensions and sessions.
  • Scaling to many parallel browsers with Browser Use Cloud for tasks requiring proxies, stealth, or CAPTCHA solving.
  • When you need your own Chrome profile and logged-in state available to the agent.

Getting started

Paste the following prompt into Claude Code or Codex (for Cursor, use the MCP configuration in the repository 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. 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.

The agent will open chrome://inspect/#remote-debugging. On first setup, tick the checkbox so the agent can connect to your browser.

License and pricing

MIT license. Open source. No pricing information is stated.

Based on the project's public README and repository metadata.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/browser-usebrowser-harness.svg)](https://yunodb.com/tools/browser-usebrowser-harness?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/browser-usebrowser-harness?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/browser-usebrowser-harness.svg" alt="Featured on YunoDB" height="20"></a>