Quickstart

Prerequisites

• macOS or Linux. The install script adds Bun 1.3 or newer, which the CLI runs on, if it is missing.
• A Phone Use account. phone-use login signs you in from the browser.
• No Mac. Cloud phones run on our hardware.

Run your first command

1. 1

   Install Phone Use

   The script installs Bun if it is missing, then the CLI. Run it again to update. phone-use doctor checks your setup.

   curl -fsSL https://phoneuse.dev/install | bash

2. 2

   Sign in

   Approve the CLI in your browser. On a machine without one, it prints a code to approve at app.phoneuse.dev/device.

   phone-use login

3. 3

   Create a phone

   An iOS phone starts warm in about two seconds. phone-use create android works the same way.

   phone-use create ios

4. 4

   Attach your shell

   Every verb now targets that phone.

   eval "$(phone-use env sbx_YOUR_ID)"

5. 5

   Inspect the screen

   Read the frontmost app and its visible elements.

   phone-use observe

6. 6

   Navigate and read

   Use the saved app map to reach About and read a labeled value.

   phone-use goto Settings About
   phone-use ask "iOS Version" --app Settings

Run a complete goal

The built-in agent loop can execute a natural-language task. It requires ANTHROPIC_API_KEY.

export ANTHROPIC_API_KEY="..."
phone-use task "Open Settings and go to Accessibility"

Run locally instead

With no cloud phone attached, the same commands drive a local device: an iOS Simulator on macOS with Xcode (open -a Simulator), or an Android emulator over adb (phone-use connect android).