@playwright/cli 0.0.62 → 0.0.64

package/README.md

@@ -27,6 +27,23 @@ npm install -g @playwright/cli@latest
 playwright-cli --help
 ```
 
+### Installing skills
+
+Claude Code, GitHub Copilot and others will use the locally installed skills.
+
+```bash
+playwright-cli install-skills
+```
+
+### Skills-less operation
+
+Point your agent at the CLI and let it cook. It'll read the skill off `playwright-cli --help` on its own:
+
+```
+Test the "add todo" flow on https://demo.playwright.dev/todomvc using playwright-cli.
+Check playwright-cli --help for available commands.
+```
+
 ## Demo
 
 ```
@@ -88,13 +105,13 @@ Playwright CLI will use a dedicated persistent profile by default. It means that
 your cookies and other storage state will be preserved between the calls. You can use different
 instances of the browser for different projects with sessions.
 
-Following will result in two browsers with separate profiles being available. Pass `--session` to
+Following will result in two browsers with separate profiles being available. Pass `-s=` to
 the invocation to talk to a specific browser.
 
 ```bash
 playwright-cli open https://playwright.dev
-playwright-cli --session=example open https://example.com
-playwright-cli session-list
+playwright-cli -s=example open https://example.com
+playwright-cli list
 ```
 
 You can run your coding agent with the `PLAYWRIGHT_CLI_SESSION` environment variable:
@@ -103,15 +120,14 @@ You can run your coding agent with the `PLAYWRIGHT_CLI_SESSION` environment vari
 PLAYWRIGHT_CLI_SESSION=todo-app claude .
 ```
 
-Or instruct it to prepend `--session` to the calls.
+Or instruct it to prepend `-s=` to the calls.
 
 Manage your sessions as follows:
 
 ```bash
-playwright-cli session-list             # list all sessions
-playwright-cli session-stop [name]      # stop session
-playwright-cli session-stop-all         # stop all sessions
-playwright-cli session-delete [name]    # delete session data along with the profiles
+playwright-cli list                     # list all sessions
+playwright-cli close-all                # close all browsers
+playwright-cli kill-all                 # forcefully kill all browser processes
 ```
 
 <!-- BEGIN GENERATED CLI HELP -->
@@ -134,6 +150,7 @@ playwright-cli upload <file>            # upload one or multiple files
 playwright-cli check <ref>              # check a checkbox or radio button
 playwright-cli uncheck <ref>            # uncheck a checkbox or radio button
 playwright-cli snapshot                 # capture page snapshot to obtain element ref
+playwright-cli snapshot --filename=f    # save snapshot to specific file
 playwright-cli eval <func> [ref]        # evaluate javascript expression on page or element
 playwright-cli dialog-accept [prompt]   # accept a dialog
 playwright-cli dialog-dismiss           # dismiss a dialog
@@ -169,7 +186,9 @@ playwright-cli mousewheel <dx> <dy>     # scroll mouse wheel
 
 ```bash
 playwright-cli screenshot [ref]         # screenshot of the current page or element
+playwright-cli screenshot --filename=f  # save screenshot with specific filename
 playwright-cli pdf                      # save page as pdf
+playwright-cli pdf --filename=page.pdf  # save pdf with specific filename
 ```
 
 ### Tabs
@@ -181,6 +200,42 @@ playwright-cli tab-close [index]        # close a browser tab
 playwright-cli tab-select <index>       # select a browser tab
 ```
 
+### Storage
+
+```bash
+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
+```
+
+### Network
+
+```bash
+playwright-cli route <pattern> [opts]   # mock network requests
+playwright-cli route-list               # list active routes
+playwright-cli unroute [pattern]        # remove route(s)
+```
+
 ### DevTools
 
 ```bash
@@ -189,6 +244,39 @@ playwright-cli network                  # list all network requests since loadin
 playwright-cli run-code <code>          # run playwright code snippet
 playwright-cli tracing-start            # start trace recording
 playwright-cli tracing-stop             # stop trace recording
+playwright-cli video-start              # start video recording
+playwright-cli video-stop [filename]    # stop video recording
+```
+
+### Install
+
+```bash
+playwright-cli install-browser          # install browser
+playwright-cli install-skills           # install skills
+```
+
+### Configuration
+
+```bash
+playwright-cli config [options]         # configure session settings
+playwright-cli open --browser=chrome    # use specific browser
+playwright-cli open --extension         # connect via browser extension
+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
+```
+
+### Sessions
+
+```bash
+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
 ```
 <!-- END GENERATED CLI HELP -->
 
@@ -343,7 +431,8 @@ Playwright CLI will load config from `playwright-cli.json` by default so that yo
 
 </details>
 
-## Environment
+<details>
+<summary>Configuration via env</summary>
 
 | Environment |
 |-------------|
@@ -389,3 +478,4 @@ Playwright CLI will load config from `playwright-cli.json` by default so that yo
 | `PLAYWRIGHT_MCP_USER_AGENT` specify user agent string |
 | `PLAYWRIGHT_MCP_USER_DATA_DIR` path to the user data directory. If not specified, a temporary directory will be created. |
 | `PLAYWRIGHT_MCP_VIEWPORT_SIZE` specify browser viewport size in pixels, for example "1280x720" |
+</details>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@playwright/cli",
-  "version": "0.0.62",
+  "version": "0.0.64",
   "description": "Playwright CLI",
   "repository": {
     "type": "git",
@@ -17,12 +17,12 @@
   "scripts": {
     "lint": "echo OK",
     "build": "echo OK",
-    "test": "echo OK"
+    "test": "playwright test"
   },
   "dependencies": {
     "minimist": "^1.2.5",
-    "playwright": "1.59.0-alpha-1769819922000",
-    "playwright-core": "1.59.0-alpha-1769819922000"
+    "playwright": "1.59.0-alpha-1770338664000",
+    "playwright-core": "1.59.0-alpha-1770338664000"
   },
   "bin": {
     "playwright-cli": "playwright-cli.js"

package/playwright-cli.js

@@ -16,8 +16,8 @@
  */
 
 const { program } = require('playwright/lib/mcp/terminal/program');
-const packageJSON = require('./package.json');
-program({ version: packageJSON.version }).catch(e => {
+const packageLocation = require.resolve('./package.json');
+program(packageLocation).catch(e => {
   console.error(e.message);
   process.exit(1);
 });