verify-atlas
Verify Atlas
Drive a running Atlas desktop build over CDP: inspect the DOM, take screenshots, click, type, read the accessibility tree, evaluate JS, and manage checkout-isolated parallel instances.
node .cursor/skills/verify-atlas/control-atlas.mjs --help lists commands, flags, and examples. This sample documents usage only; the driver scripts are not included.
Pick a flow
test -f .git && echo checkout distinguishes an isolated checkout (.git is a file) from the main workspace (.git is a directory).
- Main workspace: the desktop build runs on CDP port 9222 with the shared user-data-dir. Drive it directly without
--checkout. - Isolated checkout: every command takes
--checkoutso the port and user-data-dir are derived for this tree. That keeps the run from fighting the user's main session or polluting auth.
From a checkout, a connect/launch command without --checkout (and without an explicit --cdp) is refused. Pass --checkout, or --cdp <endpoint> if you mean another instance on purpose.
Run doctor first when anything looks off. It reports checkout context, who owns the CDP port, watcher liveness, and build freshness.