showme
Drive a headed browser to a described state, then hand the user the live window.
The state can be anything — a feature to try, a flow mid-way, a specific screen,
an edge case, or a bug. Your job is the tedious setup; theirs is the experiencing.
Depends on the playwright-cli skill and the
playwright-cli CLI. This skill only adds the headed + leave-open + handoff
wrapper — for the actual driving (navigate, snapshot, click, fill, login), load
playwright-cli and follow it; don't re-derive it here.
Steps
Preflight — run ${CLAUDE_PLUGIN_ROOT}/skills/playwright-cli/check.sh.
If it fails, stop and relay its message to the user; do not fall back to
another automation tool.
Target — from context, work out the URL (prod/staging/localhost:PORT; start the dev server first if it's this repo's app and it isn't running), the preconditions that define the state, and the point of interest. Ask one tight question only if genuinely ambiguous.
Open headed, named session (every later command carries the same -s=showme):
playwright-cli -s=showme open --headed <url>
No window? A showme session was already up headless — playwright-cli -s=showme close, then reopen. playwright-cli list shows every session and whether it is headed.
Drive to the state via the playwright-cli snapshot-and-ref loop, up to the point of interest.
Verify it yourself first — then decide whether to hand over. When the state is a claim to confirm (a bug, regression, or "X happens when you do Y"), and the key action is non-destructive, fire it yourself and check the outcome before involving the user. Don't hand over a window that "should" show something you haven't confirmed it shows.
- It reproduced → reset to just-before the action (
reload / undo) so the user can trigger it themselves, then hand over (step 5). Note that you confirmed it.
- It did NOT reproduce (false positive) → stop. Don't hand over. Tell the user the claim didn't hold, with the evidence (what you did, what actually happened vs. expected). This is the whole point of trying first: catch false positives without making the user click through a dead end.
- Action is destructive, or the state is open-ended exploration (not a specific claim) → don't fire it; leave it for the user and go to step 5.
Hand over — do NOT close. Leave the window open (the session daemon keeps it alive) and tell the user, in a few lines:
- It's open — session
showme, on which page.
- You are here — current state + what you set up (and that you confirmed the action works, if you did).
- Try this — the exact action (e.g. "click the blue Save button").
- You'll see — what should happen, so they know what to look for.
Offer playwright-cli -s=showme close for when they're done.
Notes
- Reuse login state across runs with a persistent profile:
playwright-cli -s=showme open --headed --persistent <url> (profile managed by
playwright-cli), or --profile=$HOME/.showme-profile for a directory you choose.
The in-memory default forgets everything on close.
- Never auto-close — the open window is the deliverable.
1---2name: showme3description: Open a real (headed) browser, drive it to a specific state in a web app — a feature, a flow, a particular screen, or a bug — then leave the window open for the user to click around in, with a short note on what to try and what to watch for. Use when the user wants to "show me X", "take me to that state/screen", "let me click around in it", "open a browser I can play with", "set up the repro", "drive me to <feature/flow/situation>", or describes any app state they want to experience firsthand.4---56# showme78Drive a headed browser to a described state, then hand the user the live window.9The state can be anything — a feature to try, a flow mid-way, a specific screen,10an edge case, or a bug. Your job is the tedious setup; theirs is the experiencing.1112**Depends on the [`playwright-cli`](../playwright-cli/SKILL.md) skill and the13`playwright-cli` CLI.** This skill only adds the **headed + leave-open + handoff**14wrapper — for the actual driving (navigate, snapshot, click, fill, login), load15`playwright-cli` and follow it; don't re-derive it here.1617## Steps18190. **Preflight** — run `${CLAUDE_PLUGIN_ROOT}/skills/playwright-cli/check.sh`.20 If it fails, stop and relay its message to the user; do not fall back to21 another automation tool.22231. **Target** — from context, work out the URL (prod/staging/`localhost:PORT`; start the dev server first if it's this repo's app and it isn't running), the preconditions that define the state, and the point of interest. Ask one tight question only if genuinely ambiguous.24252. **Open headed, named session** (every later command carries the same `-s=showme`):2627 ```bash28 playwright-cli -s=showme open --headed <url>29 ```3031 No window? A `showme` session was already up headless — `playwright-cli -s=showme close`, then reopen. `playwright-cli list` shows every session and whether it is headed.32333. **Drive to the state** via the `playwright-cli` snapshot-and-ref loop, up to the point of interest.34354. **Verify it yourself first — then decide whether to hand over.** When the state is a _claim to confirm_ (a bug, regression, or "X happens when you do Y"), and the key action is non-destructive, **fire it yourself and check the outcome before involving the user.** Don't hand over a window that "should" show something you haven't confirmed it shows.36 - **It reproduced** → reset to just-before the action (`reload` / undo) so the user can trigger it themselves, then hand over (step 5). Note that you confirmed it.37 - **It did NOT reproduce (false positive)** → stop. Don't hand over. Tell the user the claim didn't hold, with the evidence (what you did, what actually happened vs. expected). This is the whole point of trying first: catch false positives without making the user click through a dead end.38 - **Action is destructive, or the state is open-ended exploration** (not a specific claim) → don't fire it; leave it for the user and go to step 5.39405. **Hand over — do NOT close.** Leave the window open (the session daemon keeps it alive) and tell the user, in a few lines:41 - **It's open** — session `showme`, on which page.42 - **You are here** — current state + what you set up (and that you confirmed the action works, if you did).43 - **Try this** — the exact action (e.g. "click the blue _Save_ button").44 - **You'll see** — what should happen, so they know what to look for.4546 Offer `playwright-cli -s=showme close` for when they're done.4748## Notes4950- Reuse login state across runs with a persistent profile:51 `playwright-cli -s=showme open --headed --persistent <url>` (profile managed by52 playwright-cli), or `--profile=$HOME/.showme-profile` for a directory you choose.53 The in-memory default forgets everything on close.54- Never auto-close — the open window is the deliverable.
lttr