browser-harness

Name: browser-harness
Author: browser-use

bybrowser-use· 9 skills

Installs

289

Stars

16k

Forks

1.5k

How to install browser-harness?

browser-use/browser-harness

$npx -y skills add browser-use/browser-harness --skill browser-harness

Installs into the current project.

›Prefer a prompt? Paste this to your agent

Use this skill

Run `npx skills use "https://github.com/browser-use/browser-harness" --skill "browser-use/browser-harness"` and follow the generated skill instructions now. Read its complete output, redirecting it to a temporary file first if necessary. Resolve relative paths from the supporting-files directory it provides.

Use the whole pack

Use the skills in "https://github.com/browser-use/browser-harness" that are relevant to the current task. Run `npx skills add "https://github.com/browser-use/browser-harness"` and select the relevant skills, then follow their instructions.

Files · 1

View on GitHub

SKILL.md

1	<img src="https://raw.githubusercontent.com/browser-use/media/main/browser-harness/banner-ink.svg" alt="Browser Harness" width="100%" />
2
3	# Browser Harness ♞
4
5	Connect an LLM directly to your real browser with a thin, editable CDP harness. For browser tasks where you need complete freedom.
6
7	One websocket to Chrome, nothing between. The agent writes what's missing during execution. The harness improves itself every run.
8
9	Try browser-harness in [Browser Use Cloud](https://cloud.browser-use.com/v4?utm_campaign=browser-harness-use-in-cloud&utm_source=github) or paste the setup prompt into your coding agent.
10
11	```
12	● agent: wants to upload a file
13	│
14	● agent-workspace/agent_helpers.py → helper missing
15	│
16	● agent writes it agent_helpers.py
17	│ + custom helper
18	✓ file uploaded
19	```
20
21	You will never use the browser again.
22
23	## Setup prompt
24
25	Paste into Claude Code or Codex:
26
27	```text
28	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.
29	```
30
31	The agent will open `chrome://inspect/#remote-debugging`. Tick the checkbox so the agent can connect to your browser:
32
33	<img src="docs/setup-remote-debugging.png" alt="Remote debugging setup" width="520" style="border-radius: 12px;" />
34
35	Click Allow when the per-attach popup appears (Chrome 144+):
36
37	<img src="docs/allow-remote-debugging.png" alt="Allow remote debugging popup" width="520" style="border-radius: 12px;" />
38
39	See [agent-workspace/domain-skills/](agent-workspace/domain-skills/) for example tasks.
40
41	## Free Browser Use Cloud browsers
42
43	Stealth, sub-agents, or headless deployment.<br>
44	Browser Use Cloud free tier: 3 concurrent browsers, proxies, captcha solving, and more. No card required.
45
46	- Grab a key at [cloud.browser-use.com/new-api-key](https://cloud.browser-use.com/new-api-key)
47	- Or let the agent sign up itself via [docs.browser-use.com/llms.txt](https://docs.browser-use.com/llms.txt) (setup flow + challenge context included).
48
49	## Architecture (~1k lines across 4 core files)
50
51	- `install.md` — first-time install and browser bootstrap
52	- `SKILL.md` — day-to-day usage
53	- `src/browser_harness/` — protected core package
54	- `${XDG_CONFIG_HOME:-~/.config}/browser-harness/agent-workspace/agent_helpers.py` — helper code the agent edits
55	- `${XDG_CONFIG_HOME:-~/.config}/browser-harness/agent-workspace/domain-skills/` — reusable site-specific skills the agent edits
56
57	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 `BU_CDP_URL`, or use a Browser Use cloud browser.
58
59	## Development
60
61	From a checkout, use `./browser-harness` to run the current working tree without activating a virtualenv or depending on the globally installed command:
62
63	```bash
64	./browser-harness <<'PY'
65	print(page_info())
66	PY
67	```
68
69	Normal agent-facing docs should keep using `browser-harness`; the `./browser-harness` launcher is only for local repo testing.
70
71	## Contributing
72
73	PRs and improvements welcome. The best way to help: contribute a new domain skill under [agent-workspace/domain-skills/](agent-workspace/domain-skills/) for a site or task you use often (LinkedIn outreach, ordering on Amazon, filing expenses, etc.). Each skill teaches the agent the selectors, flows, and edge cases it would otherwise have to rediscover.
74
75	- Skills are written by the harness, not by you. Just run your task with the agent — when it figures something non-obvious out, it files the skill itself (see [SKILL.md](SKILL.md)). Please don't hand-author skill files; agent-generated ones reflect what actually works in the

6 picks

Type

Run `npx skills use "https://github.com/browser-use/browser-harness" --skill "browser-use/browser-harness"` and follow the generated skill instructions now. Read its complete output, redirecting it to a temporary file first if necessary. Resolve relative paths from the supporting-files directory it provides.

Use the skills in "https://github.com/browser-use/browser-harness" that are relevant to the current task. Run `npx skills add "https://github.com/browser-use/browser-harness"` and select the relevant skills, then follow their instructions.

browser-harness

How to install browser-harness?

Related

browser-harness

How to install browser-harness?

Related