Browse documentation

TypeScript SDK

SDK overview

Launch, observe, and control devices with @phone-use/sdk.

Launch and act

tsphone-use
import { ios } from "@phone-use/sdk";

const device = await ios.launch();
await device.apps.open("Settings");
const result = await device.tap("General");

console.log(result.message, result.changed);
await device.close();

Design goals

  • Typed, transport-neutral public API
  • Re-resolvable semantic actions instead of stale handles
  • Automatic waiting and screen settling
  • Structured results for normal action failures
  • Stable error codes for infrastructure failures
  • Device-free test doubles