Reference
CLI reference
Command groups and usage patterns for the phone-use CLI.
Top-level commands
| Command | Description |
|---|---|
| phone-use login | Sign in via the browser; saves an API key to ~/.phone-use/config.json |
| phone-use create ios | Provision a cloud phone (~2s warm) |
| phone-use list | List your cloud phones |
| phone-use env <id> | Print PHONE_USE_SANDBOX_* exports for a phone |
| phone-use close <id> | Close a cloud phone |
| phone-use install <path> | Install a local .app onto the attached cloud phone |
| phone-use vm <sub> | Operator: rent and bootstrap simulator hosts |
| phone-use mcp | Start the MCP server and live viewer |
| phone-use task "<goal>" | Run a natural-language goal |
| phone-use bench | Run the deterministic benchmark |
| phone-use atlas | Show learned maps and skills |
| phone-use export [file] | Export maps and skills |
| phone-use inspect <file> | Preview an atlas file |
| phone-use import <file> | Merge an atlas file |
Registry verbs
observe · screenshot · wait_for · tap · type · scroll · drag · handle_alert · open · nav · goto · ask · search · toggle · note · batch · skill · atlas
phone-use goto --helpOutput behavior
Output is styled in a TTY and becomes plain text when piped. NO_COLOR also disables styling.