Repository navigation
v1.0.0
brow v1.0.0
Standalone Playwright CLI for agent browser automation. Launches a real Chromium instance with an agent-friendly API — structured commands for common actions, eval escape hatch for full power.
Highlights
- Ref-based element addressing — snapshot shows [N] refs for interactive elements, click/fill by ref
- Auto-snapshot on mutations — click, fill, select return updated page state automatically
- Smart snapshots — table-aware markdown, inline list compression, adaptive node caps
- Persistent profiles — survive logins across sessions
- State save/restore — snapshot and restore cookies, localStorage, sessionStorage
- Parallel tool execution — concurrent tool calls in agent loops
Benchmarks (vs playwright-cli and MCP Playwright)
| Metric | brow | playwright-cli | MCP Playwright |
|---|---|---|---|
| Avg tokens/task | 86K | 113K | 118K |
| Success rate | 69%% | 44%% | 38%% |
| Avg wall-clock | 33s | 44s | 50s |
brow uses 24%% fewer tokens, succeeds on 25%% more tasks, and runs 25%% faster than the next-best backend.
Install
brew tap detrin/tap && brew install brow
# or
pip install brow-cli && playwright install chromium