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

bashphone-use

bun add --global phone-use
phone-use --help

For a project-local install, use bun add phone-use and invoke commands with bunx phone-use.

bashphone-use

npm install @phone-use/sdk

bashphone-use

phone-use mcp --device launch
phone-use mcp --device connect
phone-use mcp --device <simulator-udid>