Skip to content

simulator_shutdown

Shut down a specific running simulator or shut down all running simulators at once. This is useful for freeing system resources, resetting state between test runs, or cleaning up after a testing session.

Parameters

Parameter	Type	Required	Default	Description
`deviceId`	string	No	`"all"`	The UDID of a specific simulator to shut down, or `"all"` to shut down every running simulator.

Usage Examples

Shut down all running simulators

“Shut down all my simulators”

{}

Shut down all simulators explicitly

“Stop every running simulator”

{
  "deviceId": "all"
}

Shut down a specific simulator by UDID

“Shut down just the iPhone 16 Pro simulator”

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

Example Output

Single device shutdown

Simulator shut down successfully.

Name: iPhone 16 Pro
UDID: F3A1B2C3-D4E5-6789-ABCD-EF0123456789
State: Shutdown

All devices shutdown

All simulators shut down successfully.

Shut down 3 simulator(s):
  - iPhone 16 Pro (F3A1B2C3-D4E5-6789-ABCD-EF0123456789)
  - iPhone 15 (A1B2C3D4-E5F6-7890-ABCD-EF1234567890)
  - iPad Pro 13-inch (M4) (B2C3D4E5-F6A7-8901-BCDE-F12345678901)

simulator_list — Check which simulators are currently booted before shutting down
simulator_boot — Boot a simulator back up after shutdown
simulator_erase — Erase simulator content and settings (requires shutdown first)
simulator_delete — Permanently delete a simulator

Tips