Skip to content

simulator_boot

Boot a shutdown iOS simulator so it becomes ready for app installation, testing, and interaction. A simulator must be in the Booted state before you can install apps, capture screenshots, stream logs, or perform most other operations.

Parameters

Parameter	Type	Required	Default	Description
`deviceId`	string	Yes	—	The UDID or name of the simulator to boot. Use `simulator_list` to find available devices.

Usage Examples

Boot a simulator by UDID

“Boot my iPhone 16 Pro simulator”

{
  "deviceId": "F3A1B2C3-D4E5-6789-ABCD-EF0123456789"
}

Boot a simulator by name

“Start the iPhone 15 simulator”

{
  "deviceId": "iPhone 15"
}

Boot a specific test device

“Boot my iPad Air layout testing simulator”

{
  "deviceId": "iPad Air - Layout Tests"
}

Example Output

Simulator booted successfully.

Name: iPhone 16 Pro
UDID: F3A1B2C3-D4E5-6789-ABCD-EF0123456789
Runtime: iOS 18.0
State: Booted

simulator_list — Find the UDID of the simulator you want to boot
simulator_shutdown — Shut down a running simulator when done
simulator_open — Open the Simulator.app window for a booted device
app_install — Install an app on the booted simulator
app_launch — Launch an app on the booted simulator

Tips