Skip to content

simulator_erase

Erase all content and settings from a simulator, restoring it to a clean factory state. This removes all installed apps, user data, accounts, and custom settings while keeping the simulator device itself. It is the equivalent of “Erase All Content and Settings” on a physical iOS device.

Parameters

Parameter	Type	Required	Default	Description
`deviceId`	string	Yes	—	The UDID of the simulator to erase. Use `simulator_list` to find the UDID.

Usage Examples

Erase a simulator to start fresh

“Reset my iPhone 16 Pro simulator to a clean state”

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

Erase before a regression test run

“Wipe the iPad Air simulator before I run the full test suite”

{
  "deviceId": "B2C3D4E5-F6A7-8901-BCDE-F12345678901"
}

Example Output

Simulator erased successfully.

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

All apps, data, and settings have been removed.

simulator_list — Find the UDID of the simulator you want to erase
simulator_shutdown — Shut down a simulator before erasing it
simulator_boot — Boot the simulator after erasing to use it again
simulator_delete — Permanently delete a simulator instead of just erasing it
app_install — Reinstall your app after erasing

Tips