Launching Wawona, starting a machine, and capturing UI evidence is agent-device on every platform, including macOS.

agent-device --version
agent-device help workflow
open → snapshot -i → press/gesture → verify → close

Do not use osascript System Events clicks, screencapture of a window, or open -n …/Wawona.app. Those lose the instance lock and hit the wrong surface.

Wayland client content needs Multi-Touch. Use press / gesture, not click --button.

LLDB

Flake apps launch without a debugger. Pass --debug (or --debug-attach on macOS).

nix run .#wawona-macos -- --debug

Repo: debugging.md.