/axiom:ui

Drive and validate the iOS simulator UI and accessibility with xcui (plus AXe and simctl).

Command

bash

/axiom:ui

Guides you through scriptable simulator UI and accessibility testing:

Preflights the environment with xcui doctor — confirms AXe is installed (offers xcui doctor --install if missing) and a simulator is booted
Drives input via xcui – xcui tap --id <id> (a physical touch), xcui type, xcui swipe, which forward to AXe
Synchronizes with xcui wait – --for-element <id> instead of sleeping or re-screenshotting
Asserts on the accessibility tree – xcui assert --id <id> --label "…" --trait button --single (exit 1 on failure)
Sets accessibility state – xcui a11y set --toggle <name> --value on --app <bundle-id>, then re-asserts

Validating UI behavior on the simulator without a human driving it
Tapping by accessibility identifier rather than fragile pixel coordinates
Waiting for an element or app-idle instead of guessing with sleep
Running accessibility checks live — Dynamic Type, Increase Contrast, Reduce Motion, Reduce Transparency — and asserting the result

xcui auto-resolves the booted simulator when exactly one is booted; with more, it refuses to run without --udid and lists the booted devices
Output is JSON by default; add --human for prose
Exit codes: 0 pass · 1 assertion-fail/timeout · 2 environment error
A tap reports success whether or not anything happened, so confirm the result with xcui wait or xcui assert
Calling axe tap directly? Add --tap-style physical — AXe's default tap style is ignored by SwiftUI buttons, list rows, menus, and tabs

xcui Reference – full tool documentation, subcommand flags, and the verified accessibility toggles
simulator-tester – the agent that drives xcui live for test scenarios and accessibility validation
AXe (Simulator Automation) – the input/tree engine xcui builds on
/axiom:test-simulator – scenario setup (location, push, deep links); /axiom:ui owns interaction, assertion, and accessibility config