Browser Harness JS

Why it's ranked here

Its appeal is breadth with little abstraction: protocol coverage, typed parameters, direct returns, persistent state, and event handling. That makes unusual browser mechanics accessible without waiting for helper support. The same design demands strong DevTools Protocol knowledge and supplies fewer safeguards than a task-level automation framework.

What's good

Generated types preserve protocol documentation, optional parameters, return shapes, experimental commands, and deprecated commands. Calls share one browser connection, while target routing automatically attaches the active session identifier. Browser discovery covers common Chromium variants across macOS, Linux, and Windows. Focused recipes document traps involving tabs, cookies, dialogs, and frames.

Tradeoffs

There are deliberately no navigation, clicking, upload, or waiting abstractions. Users must compose low-level protocol operations and understand target routing. Remote debugging must be enabled and may require user approval. The Bun-native server evaluates arbitrary JavaScript received through a localhost endpoint, and the CLI may install Bun automatically unless explicitly prevented.

How to use it well

Use it for agents or engineers who need precise Chrome control, persistent exploratory sessions, and access to uncommon protocol features. Pair typed calls with the supplied interaction recipes, then preserve useful values between snippets. Choose another layer when you need task-level helpers, built-in workflow policies, or reliable knowledge of visible tab-strip order.

Observed

License

MIT License

Primary implementation

TypeScript with a Bash CLI wrapper

Installation surface

Installed as the cdp agent skill through npx skills add; the CLI must then be placed on PATH

Interfaces

Shell CLI, typed JavaScript SDK, localhost HTTP evaluation service, and Chrome DevTools Protocol WebSocket transport

Runtime

Bun is required; the CLI can install it automatically unless opted out

Platform support

Browser profile discovery is documented for macOS, Linux, and Windows

Package structure

The npm package is private and provides generation and REPL scripts