From 719c6d2c8048fe44d766c33da95c699a64aa9e7a Mon Sep 17 00:00:00 2001 From: Toto Leung Date: Tue, 10 Nov 2026 17:15:24 +0800 Subject: [PATCH] docs(agent-cli): require playwright 1.59+ for the project-local CLI --- agent-cli/installation.mdx | 17 ++++++++++++----- 1 file changed, 12 insertions(+), 5 deletions(-) diff --git a/agent-cli/installation.mdx b/agent-cli/installation.mdx index 9f1d58c69b..6957beccae 100644 --- a/agent-cli/installation.mdx +++ b/agent-cli/installation.mdx @@ -18,16 +18,23 @@ playwright-cli --help ## Using the version in your project -If Playwright is already a dependency of the project, the CLI is available through it — no global -install needed: +If the `playwright` package is already a dependency of the project (directly, or through +`@playwright/test`), the CLI is available through it — no global install needed for Playwright +1.59 and newer. Older local versions answer `--version` but have no `cli` subcommand. Run the +checks from the directory that declares the Playwright dependency (the workspace root in a +monorepo): ```bash npx --no-install playwright --version # check that a local Playwright exists -npx playwright cli --help +npx --no-install playwright cli list # capability probe — this one decides ``` -Everywhere these docs write `playwright-cli `, `npx playwright cli ` works the -same way. +When `cli list` succeeds, keep using `npx --no-install playwright cli `; on 1.60 and +newer its `--help` lists the commands the installed version supports. When it fails with +`error: unknown command 'cli'`, the local Playwright predates 1.59 — and when npx reports that +no local Playwright exists, there is none to use. Install the global CLI in either case. +Everywhere these docs write `playwright-cli `, `npx --no-install playwright cli +` works the same way. ## Initializing a workspace