Agent-readable docs index: /llms.txt. Full docs in one file: /llms-full.txt. Download /docs.zip to grep all markdown files locally.

Install the extension

Install from the Chrome Web Store, then click the extension icon on any tab. The icon turns green when connected.
The extension works with Chrome, Chromium, Brave, Arc, Edge, and any Chromium-based browser.
Only tabs where you click the extension icon are controllable. Other tabs stay private.

Install the CLI

npm i -g playwriter
Or use without installing:
npx playwriter@latest session new
Requirements: Node.js 18+.

Install the skill

The skill teaches your AI agent how to use Playwriter: which selectors to use, how to read snapshots, how to avoid common mistakes, and all available utilities.
npx -y skills add https://playwriter.dev
This works with any agent that supports skills (OpenCode, Cursor, Claude Code, etc.). The skill is the recommended way to use Playwriter with agents; it gives them comprehensive instructions so they can use the full API without trial and error.

Quick start

playwriter session new                    # creates sandbox, outputs id (e.g. 1)
playwriter -s 1 -e 'state.page = await context.newPage(); await state.page.goto("https://example.com")'
playwriter -s 1 -e 'console.log(await snapshot({ page: state.page }))'
playwriter -s 1 -e 'await state.page.locator("aria-ref=e5").click()'

Start Chrome for Testing

If you don't have Chrome running or want a clean instance with the extension pre-loaded:
playwriter browser start
This auto-finds Chrome for Testing or Chromium on your system, launches it with recording flags enabled, and loads the bundled Playwriter extension. You can also pass a specific browser binary:
playwriter browser start /path/to/chrome

Verify it works

After installing the extension and CLI:
  1. Open any website in Chrome
  2. Click the Playwriter extension icon (turns green)
  3. Run:
playwriter session new
playwriter -s 1 -e 'console.log(context.pages().map((p) => p.url()))'
If you see the tab URL printed, everything is working.