Playwriter

Playwriter is an open-source Chrome extension and CLI tool that connects AI agents to your running Chrome browser, rather than spawning a fresh headless instance. Built by remorses and published under the MIT License, it exposes the full Playwright API through a single execute tool, enabling agents to automate real work on sites where you're already logged in. The project reached version 0.2.0 in May 2026 and has accumulated over 3,500 GitHub stars.

What It Is

Playwriter sits in the browser automation and MCP (Model Context Protocol) category. Its core job is bridging AI agents — running in tools like Cursor, Claude Code, or OpenCode — to your actual Chrome session via a local WebSocket relay on localhost:19988. A Chrome extension attaches to tabs you explicitly enable (turning the icon green), and a CLI or MCP server sends Playwright code through that relay. The result is that agents can navigate, click, scrape, intercept network requests, set breakpoints, and record video — all within the browser you already use daily.

Architecture and How It Works

The relay server multiplexes sessions so multiple agents or CLI instances can work with the same browser simultaneously. Each session has isolated state (its own state object and variables), while browser tabs are shared. The flow is:

• The Chrome extension attaches via chrome.debugger and opens a WebSocket to the local relay
• The CLI or MCP client connects to the same relay and sends Playwright code
• CDP commands flow through the relay; the extension forwards them to Chrome and returns responses
• No Chrome restart, no special launch flags, no remote servers

The architecture explicitly avoids the "controlled by automated software" banner that Chrome's --remote-debugging-port flag triggers, because the extension approach runs silently without blocking dialogs.

Key Capabilities

Playwriter exposes capabilities that the project claims no other browser MCP provides:

• Full Playwright API via a single execute tool — no schema bloat from dozens of tool definitions
• Accessibility snapshots returning 5–20KB text representations of interactive elements with aria-ref selectors, versus 100KB+ screenshots
• Visual labels (Vimium-style, color-coded by element type) overlaid on screenshots for spatial navigation
• Debugger and live code editing — set breakpoints, step through code, and live-edit page scripts or CSS in-memory via CDP
• Network interception — capture and replay API calls, inspect schemas, debug authenticated endpoints
• Screen recording using chrome.tabCapture that survives page navigation (claimed to be 100x more efficient than Playwright's base64-per-frame approach)
• Remote access via traforo tunnels or LAN, with token-based authentication

Comparison Positioning

The project's README and docs compare Playwriter directly against Playwright MCP, BrowserMCP, Antigravity/Jetski, the Claude Browser Extension, and Chrome's built-in CDP. The consistent differentiator is using the user's existing browser session rather than spawning a fresh one — preserving login state, installed extensions, and the ability to bypass captchas by having the user solve them in the shared browser. BrowserMCP exposes 12+ dedicated tools; Playwriter uses one. The Claude Browser Extension only works with Claude; Playwriter works with any MCP client.

Setup Path

Installation requires Chrome or Chromium, Node.js 18+, and a compatible agent. The four-step setup is:

1. Install the Chrome extension from the Chrome Web Store
2. Click the extension icon on a tab to connect it (icon turns green)
3. Install the CLI globally via npm (npm i -g playwriter)
4. Install the agent skill (npx -y skills add remorses/playwriter) so the agent learns Playwriter-specific workflows

For MCP server configuration, a separate MCP.md guide is provided in the repository.

Update: playwriter@0.2.0

The latest release is playwriter@0.2.0, published on May 19, 2026. The repository was created in November 2025 and has seen active development, with the last push also in May 2026. The project is actively maintained by remorses, who also accepts GitHub Sponsors. Release notes are tracked on the GitHub releases page.