Quickstart

Prerequisites

• macOS with Xcode and an iOS Simulator runtime
• Bun 1.3 or newer
• A booted simulator, or permission for Phone Use to launch one

Run your first command

1. 1

   Install Phone Use

   Install the CLI globally with Bun.

   bun add --global phone-use

2. 2

   Boot a simulator

   Open Simulator from Xcode.

   open -a Simulator

3. 3

   Inspect the screen

   Read the frontmost app and its visible semantic elements.

   phone-use observe

4. 4

   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"