browser-harness

What's Changed

• fix: clean up unused browser recovery launch by @MagMueller in #657
• docs: retry hidden-tab scrolling after activation by @MagMueller in #658
• docs: prevent duplicate tabs across harness calls by @gregpr07 in #665
• Add MCP server wrapper over browser-harness helpers by @cckyros in #601
• fix: validate local Chrome probe by @ShiroKSH in #522
• shopify-admin: Forms app popup editing skill by @NoamAAO in #568
• docs: add X article source recovery fallback by @kleberAbreu in #515
• fix: give recorder frames the screenshot IPC timeout by @rajarshidattapy in #700
• fix: send real physical key codes for printable characters by @rajarshidattapy in #705
• fix: pick select-all modifier by browser OS, not host OS by @epoyraz in #698
• docs: drop the stale -c references left behind when the flag was removed by @rajarshidattapy in #703
• docs: clarify disabling CDP touch emulation by @gregpr07 in #667
• docs(AGENTS): add Commands, Security, and verify path for agents by @msju199 in #589
• docs: let agents choose faster long-text input by @MagMueller in #708
• Fix events.jsonl write crashing on lone surrogates in page titles by @chaucerj in #676
• fix(admin): don't treat an enclosing repo as an editable install by @ddy4633 in #562
• fix: make the MCP server installable from PyPI by @MagMueller in #711
• Narrow skill description to match When Not to Use by @illmethinks0 in #555
• fix(helpers): release the iframe session js(target_id=...) attaches by @MagMueller in #720
• feat: allow disabling the tab title marker by @MagMueller in #726
• Bump browser-harness to 0.1.11 by @gregpr07 in #732

New Contributors

• @cckyros made their first contribution in #601
• @ShiroKSH made their first contribution in #522
• @NoamAAO made their first contribution in #568
• @kleberAbreu made their first contribution in #515
• @rajarshidattapy made their first contribution in #700
• @epoyraz made their first contribution in #698
• @msju199 made their first contribution in #589
• @chaucerj made their first contribution in #676
• @ddy4633 made their first contribution in #562
• @illmethinks0 made their first contribution in #555

Full Changelog: v0.1.10...v0.1.11

What's Changed

• Add machine-readable daemon health check by @laithrw in #653
• feat: allow disabling update checks by @MagMueller in #634
• fix: redact CDP credentials from daemon logs by @MagMueller in #639
• feat: fail closed for orchestrator-owned daemons by @MagMueller in #640
• fix: separate screenshot response timeout from IPC connect timeout by @MagMueller in #641
• feat: allow suppressing Cloud live viewer by @MagMueller in #642
• fix: reuse relay blank tab placeholder by @MagMueller in #643

Full Changelog: v0.1.9...v0.1.10

What's Changed

• Improve CDP hostname logging by @MagMueller in #574
• Upgrade Pillow dependency to 12.3.0 by @sauravpanda in #578
• Document optional macOS remote-debugging approval by @MagMueller in #607
• Add macOS remote debugging approval helper by @MagMueller in #610
• Remove agent cloud signup link by @MagMueller in #611
• Simplify README and add Browser Harness demo by @MagMueller in #612
• Improve README demo and cloud section by @MagMueller in #614
• Use X video showcase in README by @MagMueller in #615
• daemon: keep named automation in reusable background tabs by @MagMueller in #618
• Bump browser-harness to 0.1.9 by @gregpr07 in #623

Full Changelog: v0.1.8...v0.1.9

Chrome no longer has to be open before you start. If no Chromium-family browser is running, the harness launches one for you — picking a profile that already has remote debugging enabled and skipping the profile picker.

• Attaches to a reusable tab (about:blank, New Tab, or an existing chrome://inspect tab) instead of always opening a new one, so startup is faster and you get fewer prompts.
• Only closes leftover chrome://inspect tabs the harness itself opened — your tabs are left alone.
• Opens chrome://inspect/#remote-debugging at most once every 3 minutes, and guards against stale DevToolsActivePort files.
• Clearer, actionable errors when setup or permissions block the connection.

You no longer have to click "Allow in Chrome" for every task! The harness now opens one connection and keeps it, so you accept once per Chrome session and never see the popup again until Chrome restarts.

Browser Harness can now record browser tasks and turn hours of agent work into short, verifiable videos.

The videos use real browser frames, clicks, cursor movement, and typing—then condense the work with concise subtitles, honest mistake-and-correction explanations, and a verified final outcome.

Video creation is built directly into Browser Harness. No separate skill or installation is required. Recordings remain off by default and can be enabled globally or requested for an individual task with prompts like “record this,” “show me what you did,” or “make a demo.”

Stable 0.1.5 release.

• Rename the packaged skill identity back to browser-harness.
• More robust CLI telemetry: skip the daemon ping when telemetry is off, log browser type (remote/local).
• Suggest the cloud browser when no local browser is available.
• Windows reliability: UTF-8 daemon logging with real startup tracebacks, per-OS Chrome profile discovery (incl. Beta/Dev via %LOCALAPPDATA%), clearer remote-debugging connection errors, and tolerate a corrupt auth.json.

Stable 0.1.4 release.

• Rename the packaged skill identity to Browser Use.
• Add Browser Use v4 guidance to the skill.
• Make the API key stdin example copy-pasteable.
• Package version bumped to 0.1.4.

Stable 0.1.3 release.

• Fix packaged skill frontmatter.
• Add regression coverage for skill metadata.
• Package version bumped to 0.1.3.

Stable 0.1.2 release.

• Minor fixes.
• Package version bumped to 0.1.2.

<img width="1456" height="816" alt="browser-use_a_hooded_traveler_in_pale_gold_robes_descending_a_0ea85327-d834-415c-84bf-4b92e492f7fb_1" src="https://github.com/user-attachments/assets/7b5771a1-62f9-430d-b7f1-be0072f0432b" />

• proper packaging support
• enable auto updates

Release candidate for browser-harness 0.1.1.\n\n- Adds PyPI release workflow and package metadata.\n- Packages the browser-harness skill for browser-harness skill.\n- Adds Browser Use Cloud auth, telemetry opt-out/status, and BH_HOME state layout.\n- Keeps browser connection management close to main's simple daemon model.\n- Adds the local dev wrapper with named-session isolation.