Skip to content

v0.5.0 — npm-only, CLI + skill first

Choose a tag to compare

@CuriosityOS CuriosityOS released this 15 Jul 17:37

BetterWright is now npm-only and CLI-first.

Added

  • betterwright skill — prints a paste-ready agent skill (CLI usage + operator guidance) so any agent with a shell tool integrates without MCP, a server, or an SDK. --claude adds SKILL.md frontmatter:
    • Claude Code: betterwright skill --claude > ~/.claude/skills/browser/SKILL.md
    • Codex: betterwright skill >> ~/.codex/AGENTS.md
    • Hermes / custom agents: append the output to the system prompt.
  • betterwright mcp — the MCP stdio server (browser, browser_download, browser_doctor) ships in the npm package behind the optional @modelcontextprotocol/sdk peer dependency.

Changed

  • Network defaults opened. Private networks and loopback are reachable by default so local dev servers and intranet hosts just work. Cloud-metadata endpoints and secret-bearing URLs stay blocked (non-configurable floor). Re-harden with --block-private-network / --block-loopback, allowPrivateNetwork: false / allowLoopback: false, or BETTERWRIGHT_BLOCK_*=1.
  • README and SETUP.md restructured around CLI + skill as the primary integration path, with Pi native and MCP as alternatives.

Removed

  • The Python package. pip install betterwright is discontinued at 0.4.0; Python agents integrate through the CLI + skill path. This removes the dual-language worker-sync, parity, and wheel machinery; the policy conformance vectors live on as a JS regression suite.

Full changelog: https://github.com/CuriosityOS/betterwright/blob/main/CHANGELOG.md