protocol-browser-anti-stall
Browser Anti-Stall Protocol (playwright-cli)
Degree of freedom: LOW. Almost every step is exact. Only "why it
stalled" and the next hypothesis are [HIGH freedom].
Apply these rules to EVERY browser action. No exceptions.
This repo drives browsers with playwright-cli, not the Playwright MCP. The MCP exposes one
browser per server and a persistent profile can only be locked by one process at a time, so
parallel agents on the same repo fight over tabs and profile locks. The CLI gives every agent its
own isolated browser via -s=<session>, costs far fewer tokens (no tool schemas or verbose trees
loaded into context), and runs natively in parallel shells.
Read references/mcp-to-cli-map.md if you encounter old browser_* MCP tool calls — it maps
every tool to its CLI command. Read references/playwright-session-coordination.md before your
first command — session naming, persistent logins (incl. the Google/CDP block), and cleanup.