Start
Installation
Install the CLI, harness, and TypeScript SDK.
Packages
| Package | Purpose | Runtime |
|---|---|---|
| phone-use | CLI, MCP, agent loop, maps, skills, viewer, traces | Bun 1.3+ |
| @phone-use/sdk | Typed lifecycle and observe/act API | Node 22+ or Bun |
Install the CLI
curl -fsSL https://phoneuse.dev/install | bash
phone-use --helpThe CLI runs on Bun 1.3 or newer. The script installs Bun if it is missing, then installs the CLI with bun add --global phone-use. Run it again to update.
With Bun already installed, you can use a package manager instead: npm install -g phone-use, bun add --global phone-use, or per project bun add phone-use and bunx phone-use.
Install the SDK
npm install @phone-use/sdkChoose a device
A cloud phone needs no device flag: attach it with eval "$(phone-use env <id>)". For a local device, choose one when you start the MCP server.
phone-use mcp --device launch
phone-use mcp --device connect
phone-use mcp --device <simulator-udid>
phone-use mcp --device android