playwright-cli

Browser Automation with playwright-cli

Using this Skill in vBot

Run CLI commands through bash on the server host. Check playwright-cli --version; these instructions accompany @playwright/cli 0.1.19. If the CLI is missing or older, follow Installation below. Node.js 18 or newer and npm are required for installation. A missing browser executable requires the browser installation command reported by the CLI. Headed windows and the annotation dashboard appear on the server host; use headless operation when that host has no graphical display.

Choose a unique browser session name for the current task and pass -s=<name> on every browser command, including the examples below. Reuse that name across calls. Close only your named session when finished; detach from browsers you attached to. Use close-all, kill-all, or profile deletion only when the user's task explicitly covers those other sessions or data.

Read linked reference files on demand with skill(name="playwright-cli", file_path="references/..."). CLI output may link to snapshots, logs, screenshots, or traces saved on the server: read the relevant files with the available file Tools. A printed file path alone does not show its contents. Keep the working directory consistent across calls. Use current snapshot refs or verified locators, inspect the resulting page before repeating an uncertain action, and verify the requested outcome.

Quick start

# open new browser
playwright-cli open
# navigate to a page
playwright-cli goto https://playwright.dev
# interact with the page using refs from the snapshot
playwright-cli click e15
playwright-cli type "page.click"
playwright-cli press Enter
# take a screenshot (rarely used, as snapshot is more common)
playwright-cli screenshot
# close the browser
playwright-cli close

Commands

Core

playwright-cli open
# open and navigate right away
playwright-cli open https://example.com/
playwright-cli goto https://playwright.dev
playwright-cli type "search query"
playwright-cli click e3
playwright-cli dblclick e7
# --submit presses Enter after filling the element
playwright-cli fill e5 "[email protected]"  --submit
playwright-cli drag e2 e8
# drop files or data onto an element (from outside the page)
playwright-cli drop e4 --path=./image.png
playwright-cli drop e4 --data="text/plain=hello world"
playwright-cli hover e4
playwright-cli select e9 "option-value"
playwright-cli upload ./document.pdf
playwright-cli check e12
playwright-cli uncheck e12
playwright-cli snapshot
# search the snapshot for text or a regexp, returns matching nodes with surrounding context
playwright-cli find "Sign in"
playwright-cli find --regex "Sign (in|up)"
# wrap the regexp in slashes to add flags, e.g. /i for case-insensitive
playwright-cli find --regex "/sign (in|up)/i"
playwright-cli eval "document.title"
playwright-cli eval "el => el.textContent" e5
# get element id, class, or any attribute not visible in the snapshot
playwright-cli eval "el => el.id" e5
playwright-cli eval "el => el.getAttribute('data-testid')" e5
playwright-cli dialog-accept
playwright-cli dialog-accept "confirmation text"
playwright-cli dialog-dismiss
playwright-cli resize 1920 1080
playwright-cli close