# browser-harness

> Claude/Codex skill by [@browser-use](https://omgskills.com/library/browser-use/index.md) · 17k stars · Updated 2026-09-07

Control a real browser via CDP: clicking, typing, navigation, logged-in sessions, JS-rendered or bot-protected pages. Not for plain HTTP fetches of public content - use curl for those.

Tags: ai-agent, browser-agent, browser-automation, browser-use, browser-use-box, browser-use-cloud, cdp, cloud-browser, llm, persistent-browser, playwright, telegram-agent, vps-agent, web-automation

## Install

```sh
git clone https://github.com/browser-use/browser-harness ~/.claude/skills/browser-harness
```

## From README

browser-harness Direct browser control via CDP. For task-specific edits, use agent-workspace/agenthelpers.py. For , , or connection problems, read https://github.com/browser-use/browser-harness/blob/main/ .md. When Not to Use A basic fetch of public information needs no browser. If a plain HTTP request can read it — a public page, an API, docs — use curl or your fetch tool, and leave the browser alone. Use browser-harness when the task needs interaction (click, type, navigate), the user's logged-in session, JS rendering, or a bot-protected page. If a direct fetch fails or returns a shell page, then escalate to the browser. Domain skills are off by default. Set BHDOMAINSKILLS=1 to enable them; see the bottom section. If BHDOMAINSKILLS=1 and the task is site-specific, read every file in the matching $BHAGENTWORKSPACE/domain-skills/ / directory before inventing an approach. Invoke as browser-harness. Use heredocs for multi-line commands. Helpers are pre-imported.

## Links

- HTML page: https://omgskills.com/skills/browser-use/browser-harness/
- GitHub: https://github.com/browser-use/browser-harness
- Author: [@browser-use](https://omgskills.com/library/browser-use/index.md)

## More skills by this author

- [browser-use](https://omgskills.com/skills/browser-use/browser-use/browser-use/index.md) — Direct browser control via CDP for web interaction: automation, scraping, testing, screenshots, and site/app work.
   - [@browser-use](https://omgskills.com/library/browser-use/index.md) · 114k stars
- [cloud](https://omgskills.com/skills/browser-use/browser-use/cloud/index.md) — Documentation reference for using Browser Use Cloud — the hosted API and SDK for browser automation.
   - [@browser-use](https://omgskills.com/library/browser-use/index.md) · 112k stars
- [open-source](https://omgskills.com/skills/browser-use/browser-use/open-source/index.md) — Documentation reference for writing Python code using the browser-use open-source library.
   - [@browser-use](https://omgskills.com/library/browser-use/index.md) · 112k stars