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 it with --device).

   phone-use login

2. 2

   Create a phone

   Warm-pool clone of a booted golden — running in roughly two seconds.

   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 simulator build.

   phone-use install ./build/MyApp.app

6. 6

   Close it

   Or walk away — the idle reaper closes and bills it automatically.

   phone-use close sbx_YOUR_ID

Watch it live

Open the console, select the phone, and Connect — the live panel streams the screen while your agent works.