playwright-cli

✓Verified·Scanned 2/18/2026

Browser automation via Playwright CLI. Open pages, interact with elements, take screenshots, and more. Ideal for coding agents and automated testing workflows.

from clawhub.ai·v77023ea·3.9 KB·0 installs

Scanned from 1.0.1 at 77023ea · Transparency log ↗

$ vett add clawhub.ai/gumadeiras/playwright-cli

Playwright CLI

Browser automation via Playwright. Token-efficient CLI for coding agents.

Installation

npm install -g @playwright/mcp@latest
playwright-cli --help

Core Commands

Command	Description
`playwright-cli open <url>`	Open URL in browser
`playwright-cli close`	Close the page
`playwright-cli type <text>`	Type text into editable element
`playwright-cli click <ref> [button]`	Click on element
`playwright-cli dblclick <ref> [button]`	Double click
`playwright-cli fill <ref> <text>`	Fill text into field
`playwright-cli drag <startRef> <endRef>`	Drag and drop
`playwright-cli hover <ref>`	Hover over element
`playwright-cli check <ref>`	Check checkbox/radio
`playwright-cli uncheck <ref>`	Uncheck checkbox
`playwright-cli select <ref> <val>`	Select dropdown option
`playwright-cli snapshot`	Capture page snapshot for refs

Navigation

playwright-cli go-back           # Go back
playwright-cli go-forward        # Go forward
playwright-cli reload            # Reload page

Keyboard & Mouse

playwright-cli press <key>       # Press key (a, arrowleft, enter...)
playwright-cli keydown <key>     # Key down
playwright-cli keyup <key>       # Key up
playwright-cli mousemove <x> <y> # Move mouse
playwright-cli mousedown [button] # Mouse down
playwright-cli mouseup [button]   # Mouse up
playwright-cli mousewheel <dx> <dy> # Scroll

Save & Export

playwright-cli screenshot [ref]  # Screenshot page or element
playwright-cli pdf               # Save as PDF

Tabs

playwright-cli tab-list          # List all tabs
playwright-cli tab-new [url]     # Open new tab
playwright-cli tab-close [index] # Close tab
playwright-cli tab-select <index> # Switch tab

DevTools

playwright-cli console [min-level]  # View console messages
playwright-cli network              # View network requests
playwright-cli run-code <code>      # Run JS snippet
playwright-cli tracing-start        # Start trace
playwright-cli tracing-stop         # Stop trace

Sessions

playwright-cli session-list         # List sessions
playwright-cli session-stop [name]  # Stop session
playwright-cli session-stop-all     # Stop all
playwright-cli session-delete [name] # Delete session data

Headed Mode

playwright-cli open https://example.com --headed

Examples

# Open and interact
playwright-cli open https://example.com
playwright-cli type "search query"
playwright-cli press Enter
playwright-cli screenshot

# Use sessions
playwright-cli open https://site1.com
playwright-cli --session=project-a open https://site2.com

Environment Variables

Variable	Description
`PLAYWRIGHT_MCP_BROWSER`	Browser: chrome, firefox, webkit, msedge
`PLAYWRIGHT_MCP_HEADLESS`	Run headless (default: headed)
`PLAYWRIGHT_MCP_ALLOWED_HOSTS`	Comma-separated allowed hosts
`PLAYWRIGHT_MCP_CONFIG`	Path to config file

Configuration

Create playwright-cli.json for persistent settings:

{
  "browser": {
    "browserName": "chromium",
    "headless": false
  },
  "outputDir": "./playwright-output",
  "console": {
    "level": "info"
  }
}

Notes

Cross-platform — requires Node.js 18+ (Linux, macOS, Windows)
Sessions persist cookies/storage by default
Use --session flag for isolated browser instances
Snapshots return element refs for subsequent commands

Source

https://github.com/microsoft/playwright-cli