# How a phone works

A phone is an iOS Simulator on a cloud Mac with Xcode 27.1, erased when it stops. Your agent drives it with its tools; there is no shell.

## Start one

Connected to NoMac over MCP, your agent already has the phone: it calls `phone` with action `start`. The phone is ready in about 4 seconds. When every phone is in use, the start waits in line for up to 5 minutes, and the wait is free.

The phone alone Any MCP client: `https://mcp.nomac.app/simulator`, with simulator-use's tool names (`cloud`, `app_run`, `ui_look`…).

A terminal On macOS, Linux or Windows: `npx simulator-use cloud start`.

Your code The [REST API](/content/docs/simulator/index.html) or the [SDKs](/content/docs/sdks/index.html).

## Devices

- **iphone** iPhone 17 Pro, iOS 27. The default, kept ready.

- **ipad** iPad Pro 11-inch (M5), iOS 27. Prepared when a start asks for it, in about a minute.

- **iphone-pro-max** iPhone 17 Pro Max, iOS 27. Prepared when a start asks for it, in about a minute.

The iPhone 17 Pro Max is the 6.9-inch size App Store Connect asks for, so its screenshots go straight to a listing.

## Limits

- **Idle** Stops after 10 minutes without a tool call or a person's input through a control link; watching does not count. 60 seconds to an hour with `idle_timeout_seconds`.

- **Time** 2 hours by default, 8 at most (`max_duration_seconds`).

- **Spend** $5 at most by default (`spend_cap_microunits`).

- **At once** 2 phones per account, beside the account's Mac. For more, see [NoMac Platform](/content/platform/index.html).

In its last 15 minutes before a limit or the end of the credit, every answer carries `stop_notice`: when the phone stops, why, and what to do. `phone` with action `extend` adds time, up to 8 hours in all.

## Cost

$0.90 an hour, billed per minute from the account's prepaid credit, one minute at least: a 12-minute session costs 18¢. Builds are included, and waiting in line is free. See [Pricing and billing](/content/docs/pricing/index.html).

## What is kept

- **Erased at stop** The phone, its apps and their data.

- **Kept for the next phone** The workspace: your projects and their build cache, so the next build is incremental. Deleted after 90 days unused.

- **Kept until deleted** [Saved states](/content/docs/simulator/state/index.html): a phone's apps and data, by name.

- **Kept 7 days** The [replay](/content/docs/simulator/watch/index.html): a video of the screen beside every tool call.

Each phone runs under its own macOS user, on its own volume, behind a firewall, on Macs that run only phones. For a shell, macOS apps, signing or TestFlight, use a [NoMac Session](/content/docs/session/index.html) Mac.

## Stop it

Terminal

```
simulator-use cloud stop
```

Over MCP, `phone` with action `stop`; over REST, `DELETE /sessions/:id`. Billing ends at the stop, and the answer links to the replay, and to the MP4 of a screen recording the stop ended (`recording`). A phone left alone stops at its idle timeout; reading it after names that recording too.
