{
  "slug": "playwright-cli-mode-and-command-set-2bb70cc96e7f",
  "title": "Playwright CLI mode and command set",
  "tools": [
    "playwright-mcp"
  ],
  "tags": [
    "agent"
  ],
  "introduced_at": "2026-01-24T01:19:21.000Z",
  "announced_at": "2026-01-24T01:19:21.000Z",
  "effective_at": null,
  "date_basis": "source-publication",
  "status": "unknown",
  "how": {
    "incantation": "When implementing or debugging a repository feature, install the CLI and read its help. Open the target page, take a snapshot to get element refs, then use the documented commands to inspect or interact with it.",
    "examples": [
      "npm install -g @playwright/mcp@latest\nplaywright-cli --help\nplaywright-cli open <url>\nplaywright-cli snapshot\nplaywright-cli click <ref>",
      "playwright-cli open <url> --headed",
      "playwright-cli --session=<name> open <url>\nplaywright-cli session-list"
    ],
    "gotchas": [
      "Version: v0.0.58",
      "Requires npm install -g @playwright/mcp@latest; install skill with `/plugin marketplace add microsoft/playwright-cli` and `/plugin install playwright-cli`, or manually download `SKILL.md` as shown in the spans",
      "<url> (required): URL to open.",
      "--headed: Show the browser when opening a page; CLI is headless by default.",
      "<ref> (required): Element reference used by commands such as click; obtain refs from a snapshot.",
      "[button]: Mouse button for click or double-click.",
      "--session=<name>: Select a browser session/profile.",
      "PLAYWRIGHT_CLI_SESSION: Environment variable to select a session for the coding agent.",
      "<func> (required): JavaScript expression evaluated on the page or element.",
      "[min-level]: Minimum console message level to list.",
      "Prerequisite: Install with npm, then run `playwright-cli --help`.",
      "Prerequisite: The release note says coding-agent environments may install the skill through plugin commands or manually from the official repository.",
      "This is the first snapshot with the essential command set, which is expected to grow.",
      "Playwright CLI is headless by default; use `--headed` with `open` to see the browser.",
      "The dedicated persistent profile preserves cookies and other storage state between calls.",
      "Use `--session` to address a specific browser profile; separate sessions provide separate profiles.",
      "Docs conflict: Newer official CLI documentation uses package `@playwright/cli`, while the v0.0.58 release note specifies `@playwright/mcp`; use the release-note package for this card's version. https://github.com/microsoft/playwright-cli",
      "Docs conflict: Newer official CLI documentation uses `-s=<name>` and `list` for sessions, while the v0.0.58 release note documents `--session=<name>` and `session-list`; use the release-note syntax for this card's version. https://github.com/microsoft/playwright-cli"
    ]
  },
  "why_it_matters": "Use Playwright commands from a coding agent to inspect and interact with a web page while implementing or debugging a repository feature.",
  "sources": [
    "https://github.com/microsoft/playwright-mcp/releases/tag/v0.0.58"
  ],
  "rank": 0.95081,
  "judge": {
    "publish": true,
    "judge_model": "codex-cli/gpt-6-luna+typesafe/jev-1.13.0",
    "prompt_version": "extract-v7+enrich-v1+judge-v2x3+jev-publish-v1"
  },
  "review_state": "approved",
  "provenance": {
    "run_id": "backfill-20261007",
    "verdict_id": "backfill-20261007:backfill-20261007-27142810e970d1c7-0:gate",
    "evidence_hash": "4067fc27ec587f8fa8e4948a4c4fbee2e38406fce2f24b41e6827db3693afe47"
  },
  "review": {
    "draft_hash": "61e80a70f47470aa84e626a609a427e6bdb6aab0027bd2b8b5cd1ff09a043a08",
    "reviewer": "publication-gate",
    "reviewed_at": "2026-10-07T00:00:00.000Z",
    "decision": "backfill-20261007:gate",
    "reason": "3 of 3 judge runs approved with p_yes >= 0.9 (mean 0.95 >= 0.9; 2 needed) and Jev gave 0.71 (>= 0.6 needed)."
  }
}