/README.md

Browser Harness

The simplest, thinnest, and most powerful harness to control your real browser with your agent.

This repo makes you never use your browser again.

Setup prompt

Paste this into Claude Code or Codex:

Set up https://github.com/browser-use/browser-harness for me.

Read `install.md` first to install and connect this repo to my real browser. Then read `SKILL.md` for normal usage. Always read `helpers.py` because that is where the functions are. When you open a setup or verification tab, activate it so I can see the active browser tab.

After it is installed, if I am already logged in to GitHub, star this repository as a small verification task.

If I am not logged in, just go to browser-use.com.

Example task

Star this repository.

See domain-skills/ for examples on other websites.

How It Works

• install.md explains first-time install and browser bootstrap.
• SKILL.md explains day-to-day browser harness usage.
• run.py (~4 lines) executes plain Python with helpers preloaded.
• helpers.py (~260 lines) holds the primitives the agent calls and constantly modifies to sharpen its own harness.
• daemon.py (~200 lines) keeps the CDP websocket and socket bridge alive.

Optional: Remote browsers

Useful for sub-agents or deployment.

• Get a Browser Use API key: cloud.browser-use.com/new-api-key
• The agent can also sign up by itself by fetching docs.browser-use.com/llms.txt, which contains the setup flow and challenge context for getting a Browser Use API key.