browser-harness is a thin layer that connects agents to browsers via an editable CDP harness.
- Clarity
- Precision
- Low verbosity
- Versatility
Core code lives in src/browser_harness/:
admin.py— daemon lifecycle, diagnostics, updates, profile managementdaemon.py— the long-lived middleman process between the browser and the agenthelpers.py— CDP wrapper and core browser primitives auto-imported into-cscriptsrun.py— thebrowser-harnessCLI
SKILL.md tells agents how to use the harness and CLI.
install.md tells agents how to install it, attach a browser, and troubleshoot.
An agent operating the harness only edits inside agent-workspace/:
agent_helpers.py— task-specific browser helpers the agent addsdomain-skills/— skills the agent writes and reads
Consider what is really needed. Prefer the smallest diff that fixes the bug.