Playwriter is a versatile tool designed to enable agents to control a user's Chrome browser either through a Chrome extension or a command-line interface (CLI). Its primary purpose is to facilitate browser automation by leveraging Playwright snippets within a stateful sandbox, allowing for advanced scripting and automation tasks directly on the user's existing browser session. Unlike traditional browser automation solutions that spawn a fresh Chrome instance—resulting in loss of logins, extensions, and increased bot detection—Playwriter connects to the user's running browser. This approach preserves all user data, logins, cookies, and installed extensions, making automation more seamless and less likely to be flagged by bot detectors.
The repository provides both a Chrome extension and a CLI tool. The extension can be installed from the Chrome Web Store, and once activated, it connects to the user's browser, indicated by a green icon. The CLI enables users to automate browser actions using Playwright's full API, with each session maintaining isolated state while sharing browser tabs across sessions. This allows multiple agents or scripts to operate concurrently without interfering with each other's workflows. Users can persist data, intercept network requests, set breakpoints, debug scripts, live-edit page code, and take labeled screenshots, all within the Playwright environment.
Playwriter is designed to work with MCP (Multi-Agent Control Protocol) clients, enabling agents to execute complex browser tasks. It supports visual labels for AI agents, using color-coded overlays to identify elements such as links, buttons, inputs, checkboxes, sliders, menus, and tabs. This feature enhances the ability of agents to interact with web pages intelligently and accurately.
A significant advantage of Playwriter is its efficiency in video recording. It uses native tab capture at 30–60 frames per second, which is substantially more efficient than Playwright's traditional method of sending base64 images for every frame. This results in smoother and less resource-intensive video automation.
The repository includes comprehensive comparisons with other browser automation tools such as Playwright MCP, BrowserMCP, Jetski (Antigravity), Claude Browser Extension, and Chrome's built-in CDP. Playwriter stands out by offering direct control over the user's existing Chrome session, full Playwright API access, raw CDP (Chrome DevTools Protocol) access, and superior video recording capabilities. It also supports collaboration within the same browser window, bypasses captchas by disconnecting the extension, and allows for autonomous agent operation without disruptive banners or confirmation dialogs.
For remote access, Playwriter can control Chrome on a remote machine using traforo tunnels or over a local network, making it suitable for scenarios like remote support or multi-machine control. Security is a core consideration: the WebSocket server runs locally, origin validation ensures only trusted extension IDs can connect, explicit consent is required for automation, and Chrome displays visible banners on controlled tabs to inform users.
Playwriter is open to sponsorship and provides troubleshooting support, including detailed relay server logs and CDP traffic summaries. Known issues include occasional Chrome bugs and mode switching, which are documented for user awareness. Overall, Playwriter offers a robust, flexible, and user-friendly solution for browser automation, catering to both individual users and advanced agent-based workflows.
