| name | run-app |
| description | Launch and drive the ClaudeLens Electron app (mock data) via a Playwright REPL to verify UI changes or take screenshots. |
Drive ClaudeLens with the REPL at .claude/skills/run-app/driver.mjs.
Default launch uses SCREENSHOT_MODE (mock fixtures from
electron/screenshotFixtures.ts — no real ~/.claude/ reads); launch real
uses real data.
Setup (from repo root)
npx tsc -p tsconfig.electron.json
npx vite --port 5173 &
Run
Interactive: node .claude/skills/run-app/driver.mjs
For agents, wrap in tmux and poll the prompt:
tmux new-session -d -s cl -x 200 -y 50
tmux send-keys -t cl 'cd <repo> && node .claude/skills/run-app/driver.mjs' Enter
timeout 20 bash -c 'until tmux capture-pane -t cl -p | grep -q "driver>"; do sleep 0.2; done'
tmux send-keys -t cl 'launch' Enter
timeout 60 bash -c 'until tmux capture-pane -t cl -p | grep -q "launched:"; do sleep 0.2; done'
tmux send-keys -t cl 'ss home' Enter
Screenshots land in /tmp/claudelens-shots/ (override: SCREENSHOT_DIR).
Always open and look at the screenshots — a blank frame means launch failed.
Quit with quit and kill the Vite process when done.
Commands
| command | effect |
|---|
launch [real] | start app (mock data; real = real ~/.claude/) |
ss [name] | screenshot → $SCREENSHOT_DIR/<name>.png |
click-text <text> | DOM-click button/link/card by text (exact, then substring) |
click <css> / wait <css> | DOM-click / wait for selector |
text [css] | print innerText (body if omitted) |
eval <js> | evaluate in page, print JSON |
theme [light|dark] | force data-theme |
quit | close app and exit |
Gotchas
- Clicks go through
page.evaluate(el.click()), not coordinates — reliable
with the app's custom chrome. Navigation is client-side state (no router):
reach views by clicking like a user (e.g. click-text webapp →
click-text Teams → click-text Open team).
- The window needs ~2.5s after
domcontentloaded (baked into launch);
give another ~1s after each navigation click before screenshotting.
- On Linux add xvfb (
xvfb-run -a node …); --no-sandbox is already applied.
