playwright-cli Documentation

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

playwright-cli install --skills

Test the "add todo" flow on https://demo.playwright.dev/todomvc using playwright-cli.
Check playwright-cli --help for available commands.

> Use playwright skills to test https://demo.playwright.dev/todomvc/.
  Take screenshots for all successful and failing scenarios.

playwright-cli open https://demo.playwright.dev/todomvc/ --headed
playwright-cli type "Buy groceries"
playwright-cli press Enter
playwright-cli type "Water flowers"
playwright-cli press Enter
playwright-cli check e21
playwright-cli check e35
playwright-cli screenshot

playwright-cli open https://playwright.dev --headed

playwright-cli open https://playwright.dev
playwright-cli -s=example open https://example.com --persistent
playwright-cli list

PLAYWRIGHT_CLI_SESSION=todo-app claude .

playwright-cli list                     # list all sessions
playwright-cli close-all                # close all browsers
playwright-cli kill-all                 # forcefully kill all browser processes

playwright-cli show

/* Detailed source-code truncated for AI context efficiency. */

playwright-cli go-back                  # go back to the previous page
playwright-cli go-forward               # go forward to the next page
playwright-cli reload                   # reload the current page

playwright-cli press <key>              # press a key on the keyboard, `a`, `arrowleft`
playwright-cli keydown <key>            # press a key down on the keyboard
playwright-cli keyup <key>              # press a key up on the keyboard

playwright-cli mousemove <x> <y>        # move mouse to a given position
playwright-cli mousedown [button]       # press mouse down
playwright-cli mouseup [button]         # press mouse up
playwright-cli mousewheel <dx> <dy>     # scroll mouse wheel

playwright-cli screenshot [ref]         # screenshot of the current page or element
playwright-cli screenshot --filename=f  # save screenshot with specific filename
playwright-cli screenshot --hires       # capture at full device pixel ratio
playwright-cli pdf                      # save page as pdf
playwright-cli pdf --filename=page.pdf  # save pdf with specific filename

playwright-cli tab-list                 # list all tabs
playwright-cli tab-new [url]            # create a new tab
playwright-cli tab-close [index]        # close a browser tab
playwright-cli tab-select <index>       # select a browser tab

playwright-cli state-save [filename]    # save storage state
playwright-cli state-load <filename>    # load storage state

# Cookies
playwright-cli cookie-list [--domain]   # list cookies
playwright-cli cookie-get <name>        # get a cookie
playwright-cli cookie-set <name> <val>  # set a cookie
playwright-cli cookie-delete <name>     # delete a cookie
playwright-cli cookie-clear             # clear all cookies

# LocalStorage
playwright-cli localstorage-list        # list localStorage entries
playwright-cli localstorage-get <key>   # get localStorage value
playwright-cli localstorage-set <k> <v> # set localStorage value
playwright-cli localstorage-delete <k>  # delete localStorage entry
playwright-cli localstorage-clear       # clear all localStorage

# SessionStorage
playwright-cli sessionstorage-list      # list sessionStorage entries
playwright-cli sessionstorage-get <k>   # get sessionStorage value
playwright-cli sessionstorage-set <k> <v> # set sessionStorage value
playwright-cli sessionstorage-delete <k>  # delete sessionStorage entry
playwright-cli sessionstorage-clear     # clear all sessionStorage

playwright-cli set-color-scheme <scheme> # emulate light or dark color scheme
playwright-cli clear-color-scheme        # clear color scheme emulation
playwright-cli set-reduced-motion <motion> # emulate reduced motion preference
playwright-cli clear-reduced-motion      # clear reduced motion emulation
playwright-cli set-forced-colors <colors> # emulate forced colors mode
playwright-cli clear-forced-colors       # clear forced colors emulation
playwright-cli set-contrast <contrast>   # emulate preferred contrast
playwright-cli clear-contrast            # clear contrast emulation
playwright-cli set-media <media>         # emulate CSS media type
playwright-cli clear-media               # clear CSS media type emulation

playwright-cli route <pattern> [opts]   # mock network requests
playwright-cli route-list               # list active routes
playwright-cli unroute [pattern]        # remove route(s)

/* Detailed source-code truncated for AI context efficiency. */

playwright-cli webmcp-list              # list webmcp tools registered by the page
playwright-cli webmcp-call <name> --params='{"query":"cats"}' # call a webmcp tool
playwright-cli webmcp-call <name> --frame=<frame> # call a tool registered in a specific frame

playwright-cli open --browser=chrome    # use specific browser
playwright-cli open --mobile            # emulate a generic mobile device
playwright-cli open --device="iPhone 15" # emulate a specific device
playwright-cli open --idle-timeout=<ms> # shut down after idle time (0 to disable)
playwright-cli attach --extension=chrome # connect via Playwright Extension
playwright-cli attach --cdp=chrome      # attach to running Chrome/Edge by channel
playwright-cli attach --cdp=<url>       # attach via CDP endpoint
playwright-cli detach                   # detach an attached session, leaves the external browser running
playwright-cli open --persistent        # use persistent profile
playwright-cli open --profile=<path>    # use custom profile directory
playwright-cli open --config=file.json  # use config file
playwright-cli close                    # close the browser
playwright-cli delete-data              # delete user data for default session

> playwright-cli goto https://example.com
### Page
- Page URL: https://example.com/
- Page Title: Example Domain
### Snapshot
[Snapshot](.playwright-cli/page-2026-02-14T19-22-42-679Z.yml)

# default - save to a file with timestamp-based name
playwright-cli snapshot

# save to file, use when snapshot is a part of the workflow result
playwright-cli snapshot --filename=after-click.yaml

# snapshot an element instead of the whole page
playwright-cli snapshot "#main"

# limit snapshot depth for efficiency, take a partial snapshot afterwards
playwright-cli snapshot --depth=4
playwright-cli snapshot e34

# include each element's bounding box as [box=x,y,width,height]
playwright-cli snapshot --boxes

# search a large snapshot instead of capturing it all — returns matching nodes
# with 3 lines of context around each match (like grep -C)
playwright-cli find "Add to cart"
playwright-cli find --regex "\\$[0-9]+\\.[0-9]{2}"
# wrap the regexp in slashes to add flags, e.g. /i for case-insensitive
playwright-cli find --regex "/sign (in|up)/i"

# get snapshot with refs
playwright-cli snapshot

# interact using a ref
playwright-cli click e15

# css selector
playwright-cli click "#main > button.submit"

# role locator
playwright-cli click "getByRole('button', { name: 'Submit' })"

# test id
playwright-cli click "getByTestId('submit-button')"

playwright-cli -s=name <cmd>            # run command in named session
playwright-cli -s=name close            # stop a named browser
playwright-cli -s=name delete-data      # delete user data for named browser
playwright-cli list                     # list all sessions
playwright-cli close-all                # close all browsers
playwright-cli kill-all                 # forcefully kill all browser processes

npx --no-install playwright --version

npm install @playwright/cli@latest

playwright-cli --config path/to/config.json open example.com

/* Detailed source-code truncated for AI context efficiency. */