Cloud quickstart

From zero to a driven phone

1. 1

   Sign in

   Opens the console in your browser; approve the CLI and a key lands in ~/.phone-use/config.json. On a machine with no browser (SSH, Docker, CI) it prints a short code to approve at app.phoneuse.dev/device instead; force that with --device.

   phone-use login

2. 2

   Create a phone

   An iOS phone comes from a warm pool and is running in about two seconds. phone-use create android works the same way.

   phone-use create ios

3. 3

   Attach your shell

   Exports the phone's endpoint and session token so every verb targets it.

   eval "$(phone-use env sbx_YOUR_ID)"

4. 4

   Drive it

   Any registry verb, or the built-in agent loop.

   phone-use observe
   phone-use task "open Settings and report the iOS version"

5. 5

   Ship your app onto it

   Uploads and installs a local iOS simulator build.

   phone-use install ./build/MyApp.app

6. 6

   Close it

   Or walk away: a phone closes itself after 15 minutes idle, and billing stops when it closes.

   phone-use close sbx_YOUR_ID

Watch it live

Open the console and select the phone. iOS phones stream live video you can tap along with; Android phones show screenshots for now.