Skip to content

Device + app state

List available simulators and paired physical devices.

list_devices()
# → [{ udid, name, os_version, target, status }, ...]

Inspect the running app: foreground/background, current view controller, process state.

app_state(bundle_id="com.acme.app")

List installed apps on the current target.

apps()

Pre-grant TCC permissions (Camera, Microphone, Location, Photos, Contacts, Calendar, Reminders) to skip first-launch alerts.

pre_grant_permissions(
bundle_id="com.acme.app",
permissions=["camera", "microphone", "location_always"]
)

Switch the simulator between light and dark mode.

set_appearance(mode="dark")