Reference
Environment variables
Configure device selection, agent access, persistence, and terminal output.
Variables
| Variable | Purpose |
|---|---|
| PHONE_USE_DEVICE | launch, connect, or a simulator UDID |
| PHONE_USE_CLOUD_URL | Control-plane URL (set by phone-use login) |
| PHONE_USE_CLOUD_TOKEN | API key for cloud phones (set by phone-use login) |
| PHONE_USE_SANDBOX_URL | A cloud phone's endpoint — routes every verb to it |
| PHONE_USE_SANDBOX_TOKEN | That phone's session token |
| PHONE_USE_RUNNER_URL | On-device runner endpoint (physical phones) |
| ANTHROPIC_API_KEY | Built-in task loop and embedded sessions |
| PHONE_USE_MODE | observe, default, or auto |
| PHONE_USE_MODEL | Built-in agent model |
| PHONE_USE_MAX_STEPS | Maximum agent iterations |
| PHONE_USE_NOTES | Scratchpad persistence file |
| PHONE_USE_MAP_DIR | App-map directory |
| PHONE_USE_SKILL_DIR | Compiled-skill directory |
| PHONE_USE_TRACE_MODE | on, on-failure, or off when unset |
| PHONE_USE_TRACE_OUT | Portable trace zip destination |
| PHONE_USE_LIVE_PORT | Viewer port; defaults to 4936 |
| NO_COLOR | Disable terminal styling |
Traces
export PHONE_USE_TRACE_MODE="on-failure"
export PHONE_USE_TRACE_OUT="$PWD/phone-use-trace.zip"