Skill v1.0.0
currentAutomated scan100/100version: "1.0.0" name: patchright-cli description: Automates browser interactions for web testing, form filling, screenshots, and data extraction. Use when the user needs to navigate websites, interact with web pages, fill forms, take screenshots, test web applications, or extract information from web pages. allowed-tools: Bash(patchright-cli:*)
Browser Automation with patchright-cli
Quick start
# open new browserpatchright-cli open# navigate to a pagepatchright-cli goto https://playwright.dev# interact with the page using refs from the snapshotpatchright-cli click e15patchright-cli type "page.click"patchright-cli press Enter# take a screenshot (rarely used, as snapshot is more common)patchright-cli screenshot# close the browserpatchright-cli close
Commands
Core
patchright-cli open# open and navigate right awaypatchright-cli open https://example.com/patchright-cli goto https://playwright.devpatchright-cli type "search query"patchright-cli click e3patchright-cli dblclick e7patchright-cli fill e5 "user@example.com"patchright-cli drag e2 e8patchright-cli hover e4patchright-cli select e9 "option-value"patchright-cli upload ./document.pdfpatchright-cli check e12patchright-cli uncheck e12patchright-cli snapshotpatchright-cli snapshot --filename=after-click.yamlpatchright-cli eval "document.title"patchright-cli eval "el => el.textContent" e5patchright-cli dialog-acceptpatchright-cli dialog-accept "confirmation text"patchright-cli dialog-dismisspatchright-cli resize 1920 1080patchright-cli close
Navigation
patchright-cli go-backpatchright-cli go-forwardpatchright-cli reload
Keyboard
patchright-cli press Enterpatchright-cli press ArrowDownpatchright-cli keydown Shiftpatchright-cli keyup Shift
Mouse
patchright-cli mousemove 150 300patchright-cli mousedownpatchright-cli mousedown rightpatchright-cli mouseuppatchright-cli mouseup rightpatchright-cli mousewheel 0 100
Save as
patchright-cli screenshotpatchright-cli screenshot e5patchright-cli screenshot --filename=page.pngpatchright-cli pdf --filename=page.pdf
Tabs
patchright-cli tab-listpatchright-cli tab-newpatchright-cli tab-new https://example.com/pagepatchright-cli tab-closepatchright-cli tab-close 2patchright-cli tab-select 0
Storage
patchright-cli state-savepatchright-cli state-save auth.jsonpatchright-cli state-load auth.json# Cookiespatchright-cli cookie-listpatchright-cli cookie-list --domain=example.compatchright-cli cookie-get session_idpatchright-cli cookie-set session_id abc123patchright-cli cookie-set session_id abc123 --domain=example.com --httpOnly --securepatchright-cli cookie-delete session_idpatchright-cli cookie-clear# LocalStoragepatchright-cli localstorage-listpatchright-cli localstorage-get themepatchright-cli localstorage-set theme darkpatchright-cli localstorage-delete themepatchright-cli localstorage-clear# SessionStoragepatchright-cli sessionstorage-listpatchright-cli sessionstorage-get steppatchright-cli sessionstorage-set step 3patchright-cli sessionstorage-delete steppatchright-cli sessionstorage-clear
Network
patchright-cli route "**/*.jpg" --status=404patchright-cli route "https://api.example.com/**" --body='{"mock": true}'patchright-cli route-listpatchright-cli unroute "**/*.jpg"patchright-cli unroute
DevTools
patchright-cli consolepatchright-cli console warningpatchright-cli networkpatchright-cli run-code "async page => await page.context().grantPermissions(['geolocation'])"patchright-cli tracing-startpatchright-cli tracing-stoppatchright-cli video-startpatchright-cli video-stop video.webm
Open parameters
# Use specific browser when creating sessionpatchright-cli open --browser=chromepatchright-cli open --browser=firefoxpatchright-cli open --browser=webkitpatchright-cli open --browser=msedge# Connect to browser via extensionpatchright-cli open --extension# Use persistent profile (by default profile is in-memory)patchright-cli open --persistent# Use persistent profile with custom directorypatchright-cli open --profile=/path/to/profile# Start with config filepatchright-cli open --config=my-config.json# Close the browserpatchright-cli close# Delete user data for the default sessionpatchright-cli delete-data
Snapshots
After each command, patchright-cli provides a snapshot of the current browser state.
> patchright-cli goto https://example.com### Page- Page URL: https://example.com/- Page Title: Example Domain### Snapshot[Snapshot](.patchright-cli/page-2026-02-14T19-22-42-679Z.yml)
You can also take a snapshot on demand using patchright-cli snapshot command.
If --filename is not provided, a new snapshot file is created with a timestamp. Default to automatic file naming, use --filename= when artifact is a part of the workflow result.
Browser Sessions
# create new browser session named "mysession" with persistent profilepatchright-cli -s=mysession open example.com --persistent# same with manually specified profile directory (use when requested explicitly)patchright-cli -s=mysession open example.com --profile=/path/to/profilepatchright-cli -s=mysession click e6patchright-cli -s=mysession close # stop a named browserpatchright-cli -s=mysession delete-data # delete user data for persistent sessionpatchright-cli list# Close all browserspatchright-cli close-all# Forcefully kill all browser processespatchright-cli kill-all
Local installation
In some cases user might want to install patchright-cli locally. If running globally available patchright-cli binary fails, use npx patchright-cli to run the commands. For example:
npx patchright-cli open https://example.comnpx patchright-cli click e1
Example: Form submission
patchright-cli open https://example.com/formpatchright-cli snapshotpatchright-cli fill e1 "user@example.com"patchright-cli fill e2 "password123"patchright-cli click e3patchright-cli snapshotpatchright-cli close
Example: Multi-tab workflow
patchright-cli open https://example.compatchright-cli tab-new https://example.com/otherpatchright-cli tab-listpatchright-cli tab-select 0patchright-cli snapshotpatchright-cli close
Example: Debugging with DevTools
patchright-cli open https://example.compatchright-cli click e4patchright-cli fill e7 "test"patchright-cli consolepatchright-cli networkpatchright-cli close
patchright-cli open https://example.compatchright-cli tracing-startpatchright-cli click e4patchright-cli fill e7 "test"patchright-cli tracing-stoppatchright-cli close
Specific tasks
- Request mocking references/request-mocking.md
- Running Playwright code references/running-code.md
- Browser session management references/session-management.md
- Storage state (cookies, localStorage) references/storage-state.md
- Test generation references/test-generation.md
- Tracing references/tracing.md
- Video recording references/video-recording.md