diff --git a/README.md b/README.md
index b7a0962..5efbeed 100644
--- a/README.md
+++ b/README.md
@@ -249,7 +249,7 @@ playwright-cli video-start [filename] # start video recording
playwright-cli video-chapter
# add a chapter marker to the video
playwright-cli video-stop # stop video recording
playwright-cli show # open the visual dashboard
-playwright-cli annotate # launch dashboard for UI review / design feedback
+playwright-cli show --annotate # launch dashboard with annotation prompt
playwright-cli generate-locator [ # generate a playwright locator for an element
playwright-cli highlight ][ # show a persistent highlight overlay
playwright-cli highlight ][ --style= # highlight with a custom CSS style
diff --git a/package-lock.json b/package-lock.json
index c5c20aa..5cd5a48 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -9,13 +9,13 @@
"version": "0.1.9",
"license": "Apache-2.0",
"dependencies": {
- "playwright": "1.60.0-alpha-1777566615000"
+ "playwright": "1.60.0-alpha-1777575331000"
},
"bin": {
"playwright-cli": "playwright-cli.js"
},
"devDependencies": {
- "@playwright/test": "1.60.0-alpha-1777566615000",
+ "@playwright/test": "1.60.0-alpha-1777575331000",
"@types/node": "^25.2.1"
},
"engines": {
@@ -23,13 +23,13 @@
}
},
"node_modules/@playwright/test": {
- "version": "1.60.0-alpha-1777566615000",
- "resolved": "https://registry.npmjs.org/@playwright/test/-/test-1.60.0-alpha-1777566615000.tgz",
- "integrity": "sha512-EBGZI/5WjEhIvXsa+6q7XrYDif1YyL9bmp7t6IKN4Aa/OWedI7Pw9a6Calk5Uqx6SNCco8qTXHpBI95+5+mvww==",
+ "version": "1.60.0-alpha-1777575331000",
+ "resolved": "https://registry.npmjs.org/@playwright/test/-/test-1.60.0-alpha-1777575331000.tgz",
+ "integrity": "sha512-g3/CQYL/GBGu723pK5R6tzIJ01VWrOCxaAGSZ+V0jBUo9cAfxg1RrtYxX7HKEJdFvMewUtToE1/HOGR/iA3jXQ==",
"dev": true,
"license": "Apache-2.0",
"dependencies": {
- "playwright": "1.60.0-alpha-1777566615000"
+ "playwright": "1.60.0-alpha-1777575331000"
},
"bin": {
"playwright": "cli.js"
@@ -63,12 +63,12 @@
}
},
"node_modules/playwright": {
- "version": "1.60.0-alpha-1777566615000",
- "resolved": "https://registry.npmjs.org/playwright/-/playwright-1.60.0-alpha-1777566615000.tgz",
- "integrity": "sha512-ENFFNacDBbDBLUtn4FsdZowN9CxsO22/xlgvhgiyzW6FM/PoWM5GSwNl2c0LMvcFYkmmPbB6uGHFL9T2U9ufVQ==",
+ "version": "1.60.0-alpha-1777575331000",
+ "resolved": "https://registry.npmjs.org/playwright/-/playwright-1.60.0-alpha-1777575331000.tgz",
+ "integrity": "sha512-TYI1/8r4dZvIGx7GKHeZB988av806iVPsYlFIqZEYibzgHzcFvYpAGhsT2EfkPlAJr3oj1VB2v+qOX63N4g98w==",
"license": "Apache-2.0",
"dependencies": {
- "playwright-core": "1.60.0-alpha-1777566615000"
+ "playwright-core": "1.60.0-alpha-1777575331000"
},
"bin": {
"playwright": "cli.js"
@@ -81,9 +81,9 @@
}
},
"node_modules/playwright-core": {
- "version": "1.60.0-alpha-1777566615000",
- "resolved": "https://registry.npmjs.org/playwright-core/-/playwright-core-1.60.0-alpha-1777566615000.tgz",
- "integrity": "sha512-68GgyVu5NAgQzU8YdbYS/PZCStmiJoV3kclnAIb9Yau+wj23O1pLyMprw2MgenE0lIBU5aFvkHdv/LB8oMd1Xg==",
+ "version": "1.60.0-alpha-1777575331000",
+ "resolved": "https://registry.npmjs.org/playwright-core/-/playwright-core-1.60.0-alpha-1777575331000.tgz",
+ "integrity": "sha512-kdE6dgKSqblFZegsB2A50urVCTHddjTs7i48W8mD5huaO9SZh6Ch4xG2qe9spw6ILGjGLp2VMxXk8uYY91e1JQ==",
"license": "Apache-2.0",
"bin": {
"playwright-core": "cli.js"
diff --git a/package.json b/package.json
index dc8b06e..13a3f73 100644
--- a/package.json
+++ b/package.json
@@ -18,11 +18,11 @@
"test": "playwright test"
},
"devDependencies": {
- "@playwright/test": "1.60.0-alpha-1777566615000",
+ "@playwright/test": "1.60.0-alpha-1777575331000",
"@types/node": "^25.2.1"
},
"dependencies": {
- "playwright": "1.60.0-alpha-1777566615000"
+ "playwright": "1.60.0-alpha-1777575331000"
},
"bin": {
"playwright-cli": "playwright-cli.js"
diff --git a/skills/playwright-cli/SKILL.md b/skills/playwright-cli/SKILL.md
index 4111868..f9bc753 100644
--- a/skills/playwright-cli/SKILL.md
+++ b/skills/playwright-cli/SKILL.md
@@ -163,8 +163,8 @@ playwright-cli video-start video.webm
playwright-cli video-chapter "Chapter Title" --description="Details" --duration=2000
playwright-cli video-stop
-# launch the dashboard for UI review / design feedback — user annotates the page, you receive the annotated screenshot, snapshot, and notes
-playwright-cli annotate
+# launch the dashboard with annotation prompt to ask the user for input
+playwright-cli show --annotate
# generate a Playwright locator for an element from its ref or selector
playwright-cli generate-locator e5 --raw
@@ -367,11 +367,11 @@ playwright-cli close
## Example: Interactive session
-Ask the user for UI review or design feedback. The user draws boxes on the live page and types comments; you receive the annotated screenshot, the snapshot of the marked region, and the user's notes. Use this whenever the user asks for "UI review", "design feedback", or to "ask the user what they think / want / mean":
+Ask the user to annotate the UI. User can provide contextual tasks or ask contextual questions using annotations:
```bash
playwright-cli open https://example.com
-playwright-cli annotate
+playwright-cli show --annotate
```
## Specific tasks
diff --git a/skills/playwright-cli/references/spec-driven-testing.md b/skills/playwright-cli/references/spec-driven-testing.md
index 5097a67..f37bdb4 100644
--- a/skills/playwright-cli/references/spec-driven-testing.md
+++ b/skills/playwright-cli/references/spec-driven-testing.md
@@ -88,7 +88,7 @@ playwright-cli resume # resume so that seed test runs fully
playwright-cli snapshot # inventory of interactive elements
playwright-cli click e5 # follow a flow
playwright-cli eval "location.href" # read URL / state
-playwright-cli annotate # ask the user to point at something
+playwright-cli show --annotate # ask the user to point at something
```
Map out:
@@ -262,7 +262,7 @@ The test is paused at the start. Step forward or run to until just before the fa
playwright-cli snapshot # did the element change / move / rename?
playwright-cli console # app-side errors?
playwright-cli network # failed request? wrong payload?
-playwright-cli annotate # ask the user to point somewhere
+playwright-cli show --annotate # ask the user to point somewhere
```
Common causes: selector drift, new wrapper element, label/ARIA rename, timing (transition, async load), assertion text updated in the app, test data leaking between runs.
]