$npx -y skills add tody-agent/codymaster --skill cm-browseUse when you need visual QA, screenshots, or post-deploy smoke testing through a real browser with Playwright.
| 1 | # cm-browse — local Playwright daemon |
| 2 | |
| 3 | > **Full runbook:** [docs/browse-daemon.md](../../docs/browse-daemon.md) (install Chromium, token, troubleshooting). |
| 4 | |
| 5 | ## When to use |
| 6 | |
| 7 | - Visual QA, screenshots, post-deploy smoke through a **real browser** (not only Stitch/Pencil). |
| 8 | - Before claiming “UI works”, drive `cm browse` + `cm qa-visual`. |
| 9 | |
| 10 | ## CLI |
| 11 | |
| 12 | ```bash |
| 13 | export CM_BROWSE_TOKEN="$(openssl rand -hex 24)" |
| 14 | cm browse start --port 17395 --token "$CM_BROWSE_TOKEN" |
| 15 | ``` |
| 16 | |
| 17 | ## HTTP API (Bearer token) |
| 18 | |
| 19 | - `POST /session/start` body `{ "headless": true }` |
| 20 | - `POST /navigate` `{ "url": "https://…" }` |
| 21 | - `POST /refs/refresh` — assigns `data-cm-ref` to interactive nodes; use `@e1` style refs. |
| 22 | - `POST /click` `{ "ref": "e1" }` |
| 23 | - `POST /fill` `{ "ref": "e2", "value": "text" }` |
| 24 | - `GET /screenshot` — PNG |
| 25 | - `GET /console` / `GET /network` — ring buffers |
| 26 | |
| 27 | ## Integrations |
| 28 | |
| 29 | - `cm qa-visual --url …` calls the daemon locally. |
| 30 | - Pair with `cm-canary` / `cm-safe-deploy` for ship verification. |