Use Phone Use
Use the CLI
Operate a phone with composable one-shot shell commands.
Start with observation
phone-use observeTarget elements by label. Element references such as @e4 belong to one observation and should not cross separate CLI invocations.
Device primitives
phone-use open Settings
phone-use tap "General"
phone-use type "Ada" --field "First name"
phone-use scroll down
phone-use nav back
phone-use wait_for "About"Intent verbs
phone-use goto Settings About
phone-use ask "Model Name" --app Settings
phone-use search Maps coffee --open
phone-use toggle Settings "Full-Screen Previews" --ongotocomputes and replays the shortest known route.askfinds a labeled value and reads it.searchhandles native search patterns and can open a matching result.togglesets the requested switch state idempotently.
Carry data between commands
export PHONE_USE_NOTES="$PWD/.phone-use-notes.json"
phone-use note save device-model "iPhone 17 Pro"
phone-use note read device-model