# What changed in @playwright/cli

> 43 changes in @playwright/cli 0.1 from its official release notes, upgrade guides and advisories: 4 breaking, 1 security, 19 new APIs and options. Each one cited. Sources checked 2026-10-18. HTML: https://unstale.sh/npm/@playwright/cli/

To see which of these apply to a repository, run `npx @unstale/cli init` in it.

## @playwright/cli 0.1

### Breaking changes

- Works with Chromium 155 and later. (0.1.22) — [release notes](https://github.com/microsoft/playwright-cli/releases/tag/v0.1.22)
- Adds CSS styling for the target highlight; the highlight is shown only when styled. (0.1.21) — [release notes](https://github.com/microsoft/playwright-cli/releases/tag/v0.1.21)
- Adds CSS styling for action point markers; the marker is shown only when styled. (0.1.21) — [release notes](https://github.com/microsoft/playwright-cli/releases/tag/v0.1.21)
- Headless sessions shut down after one hour without commands, so an unclosed session no longer holds a browser; headed browsers stay open. (0.1.20) — [release notes](https://github.com/microsoft/playwright-cli/releases/tag/v0.1.20)

### Security

- Preapproves Playwright commands only, rather than any npm or npx command. (0.1.22) — [release notes](https://github.com/microsoft/playwright-cli/releases/tag/v0.1.22)

### New APIs and options

- When a query produces too many matches, `--filename` saves them to a file. (0.1.22) — [release notes](https://github.com/microsoft/playwright-cli/releases/tag/v0.1.22)
- Set filePaths to "absolute" in the config file to get absolute paths for snapshots, screenshots, console logs, and downloads. (0.1.21) — [release notes](https://github.com/microsoft/playwright-cli/releases/tag/v0.1.21)
- Set PLAYWRIGHT_MCP_FILE_PATHS=absolute to get absolute paths for snapshots, screenshots, console logs, and downloads. (0.1.21) — [release notes](https://github.com/microsoft/playwright-cli/releases/tag/v0.1.21)
- Set PLAYWRIGHT_MCP_WEBMCP=false to stop collecting page-registered tools. (0.1.21) — [release notes](https://github.com/microsoft/playwright-cli/releases/tag/v0.1.21)
- Emulates a color scheme on the fly, letting an agent switch between light and dark during a session. (0.1.21) — [release notes](https://github.com/microsoft/playwright-cli/releases/tag/v0.1.21)
- Emulates the contrast media feature on the fly. (0.1.21) — [release notes](https://github.com/microsoft/playwright-cli/releases/tag/v0.1.21)
- Emulates the forced-colors media feature on the fly. (0.1.21) — [release notes](https://github.com/microsoft/playwright-cli/releases/tag/v0.1.21)
- Emulates media features on the fly. (0.1.21) — [release notes](https://github.com/microsoft/playwright-cli/releases/tag/v0.1.21)
- Emulates the reduced-motion media feature on the fly. (0.1.21) — [release notes](https://github.com/microsoft/playwright-cli/releases/tag/v0.1.21)
- Adds CSS declarations for styling video action titles. (0.1.21) — [release notes](https://github.com/microsoft/playwright-cli/releases/tag/v0.1.21)
- The --cursor option renders an animated mouse cursor that travels to each action point and stays visible between actions. (0.1.21) — [release notes](https://github.com/microsoft/playwright-cli/releases/tag/v0.1.21)
- The --fps option records videos at a chosen frame rate; --fps=60 records smooth 60 fps videos instead of the default 25. (0.1.21) — [release notes](https://github.com/microsoft/playwright-cli/releases/tag/v0.1.21)
- Set webmcp to false in the config file to stop collecting page-registered tools. (0.1.21) — [release notes](https://github.com/microsoft/playwright-cli/releases/tag/v0.1.21)
- Sets an idle timeout for attached browsers; they are only detached when this option is set. (0.1.20) — [release notes](https://github.com/microsoft/playwright-cli/releases/tag/v0.1.20)
- Sets the idle timeout for a headless session; 0 disables the timeout. (0.1.20) — [release notes](https://github.com/microsoft/playwright-cli/releases/tag/v0.1.20)
- Sets the idle timeout for a headless session; 0 disables the timeout. (0.1.20) — [release notes](https://github.com/microsoft/playwright-cli/releases/tag/v0.1.20)
- Configures the idle timeout for a headless session; 0 disables the timeout. (0.1.20) — [release notes](https://github.com/microsoft/playwright-cli/releases/tag/v0.1.20)
- Calls tools a page registers through the WebMCP API, letting the page do the work instead of driving its UI. (0.1.20) — [release notes](https://github.com/microsoft/playwright-cli/releases/tag/v0.1.20)
- Lists the tools a page registers through the WebMCP API. (0.1.20) — [release notes](https://github.com/microsoft/playwright-cli/releases/tag/v0.1.20)

### Behavior and default changes

- Scripts can use timers, fetch, URL, Buffer, crypto, AbortController, TextEncoder, and TextDecoder; require and process remain unavailable. (0.1.22) — [release notes](https://github.com/microsoft/playwright-cli/releases/tag/v0.1.22)
- Page-registered WebMCP tools, descriptions, and input schemas appear at the top of the snapshot, so webmcp-call works without first running webmcp-list. (0.1.21) — [release notes](https://github.com/microsoft/playwright-cli/releases/tag/v0.1.21)
- The Chromium sandbox is disabled by default on Linux for the bundled Chromium build, which lacks the setuid sandbox helper. (0.1.20) — [release notes](https://github.com/microsoft/playwright-cli/releases/tag/v0.1.20)
- Session daemons exit when their control socket is deleted or replaced instead of staying alive with the browser. (0.1.20) — [release notes](https://github.com/microsoft/playwright-cli/releases/tag/v0.1.20)

### Fixes and other changes

- The session no longer crashes if the browser closes during a download. (0.1.22) — [release notes](https://github.com/microsoft/playwright-cli/releases/tag/v0.1.22)
- Reports a dialog opened during page load instead of timing out. (0.1.22) — [release notes](https://github.com/microsoft/playwright-cli/releases/tag/v0.1.22)
- Accepts `--no-shell` instead of failing with an unknown-option error. (0.1.22) — [release notes](https://github.com/microsoft/playwright-cli/releases/tag/v0.1.22)
- Reports a dialog opened during page load instead of timing out. (0.1.22) — [release notes](https://github.com/microsoft/playwright-cli/releases/tag/v0.1.22)
- Quotes accessible names that look like regular expressions. (0.1.22) — [release notes](https://github.com/microsoft/playwright-cli/releases/tag/v0.1.22)
- No longer runs a tool in a stale tab or frame. (0.1.22) — [release notes](https://github.com/microsoft/playwright-cli/releases/tag/v0.1.22)
- Matching clear-* commands reset media feature emulation. (0.1.21) — [release notes](https://github.com/microsoft/playwright-cli/releases/tag/v0.1.21)
- route ignores header lines that have no name. (0.1.21) — [release notes](https://github.com/microsoft/playwright-cli/releases/tag/v0.1.21)
- Secrets shorter than 4 characters no longer rewrite the whole output with <secret> markers. (0.1.21) — [release notes](https://github.com/microsoft/playwright-cli/releases/tag/v0.1.21)
- state-save bypasses service workers on the storage state page, avoiding site scripts and failures when they redirect. (0.1.21) — [release notes](https://github.com/microsoft/playwright-cli/releases/tag/v0.1.21)
- A failed upload keeps the file chooser open so the upload can be retried. (0.1.21) — [release notes](https://github.com/microsoft/playwright-cli/releases/tag/v0.1.21)
- When the extension does not connect, attach fails after 30 seconds with a hint instead of hanging indefinitely. (0.1.20) — [release notes](https://github.com/microsoft/playwright-cli/releases/tag/v0.1.20)
- The CLI debugger works for tests that create multiple browser contexts and for every test in a worker. (0.1.20) — [release notes](https://github.com/microsoft/playwright-cli/releases/tag/v0.1.20)
- Explicitly named output files in nested directories no longer fail with ENOENT. (0.1.20) — [release notes](https://github.com/microsoft/playwright-cli/releases/tag/v0.1.20)
- Video chapters and screencast overlays remain visible above open dialogs and popovers. (0.1.20) — [release notes](https://github.com/microsoft/playwright-cli/releases/tag/v0.1.20)