cm-browse

name	cm-browse
description	Use when you need visual QA, screenshots, or post-deploy smoke testing through a real browser with Playwright.

cm-browse — local Playwright daemon

Full runbook: docs/browse-daemon.md (install Chromium, token, troubleshooting).

When to use

• Visual QA, screenshots, post-deploy smoke through a real browser (not only Stitch/Pencil).
• Before claiming “UI works”, drive cm browse + cm qa-visual.

CLI

export CM_BROWSE_TOKEN="$(openssl rand -hex 24)"
cm browse start --port 17395 --token "$CM_BROWSE_TOKEN"

HTTP API (Bearer token)

• POST /session/start body { "headless": true }
• POST /navigate { "url": "https://…" }
• POST /refs/refresh — assigns data-cm-ref to interactive nodes; use @e1 style refs.
• POST /click { "ref": "e1" }
• POST /fill { "ref": "e2", "value": "text" }
• GET /screenshot — PNG
• GET /console / GET /network — ring buffers

Integrations

• cm qa-visual --url … calls the daemon locally.
• Pair with cm-canary / cm-safe-deploy for ship verification.