cmux-browser

Source excerpt starting at line 1.

1# Snapshot and Refs2 3Instead of dumping the DOM and guessing selectors, snapshot the page and act on the returned refs (`e1`, `e2`, ...). Related: [commands.md](commands.md), [../SKILL.md](../SKILL.md).4 5Set `SURFACE` from creation or6[surface discovery](surface-discovery.md) before taking the snapshot.7 8```bash9cmux browser --surface "$SURFACE" snapshot10cmux browser --surface "$SURFACE" snapshot --interactive11cmux browser --surface "$SURFACE" snapshot --interactive --compact --max-depth 312 13cmux browser --surface "$SURFACE" fill e10 "$APP_USERNAME"14cmux browser --surface "$SURFACE" fill e11 "$APP_PASSWORD"15cmux browser --surface "$SURFACE" click e1216```17 18## Ref lifecycle19 20Refs are invalidated when page structure changes. Snapshot before interacting, re-snapshot after navigation and modal open/close, and use `--snapshot-after` on mutating actions so the fresh snapshot comes back with the result.21 22## Troubleshooting23 24- **`not_found` / stale ref**: take a fresh `snapshot --interactive`.25- **Element missing on visibility or timing**: `wait --selector "#target" --timeout-ms 10000`, or `scroll --dy 400`, then re-snapshot.26- **Too many elements**: scope the snapshot, e.g. `snapshot --selector "form#checkout" --interactive`.27