Skip to content

simulator_delete

Permanently delete a specific simulator by its UDID, or remove all unavailable simulators (devices whose runtime is no longer installed). Deleting simulators you no longer need keeps your device list clean and frees disk space.

Parameters

Parameter	Type	Required	Default	Description
`deviceId`	string	Yes	—	The UDID of the simulator to delete, or `"unavailable"` to remove all simulators whose runtime is no longer installed.

Usage Examples

Delete a specific simulator

“Delete the old iPhone 14 test simulator”

{
  "deviceId": "A1B2C3D4-E5F6-7890-ABCD-EF1234567890"
}

Remove all unavailable simulators

“Clean up simulators with missing runtimes”

{
  "deviceId": "unavailable"
}

Example Output

Single device deletion

Simulator deleted successfully.

Deleted: iPhone 14 - Old Tests (A1B2C3D4-E5F6-7890-ABCD-EF1234567890)

Unavailable devices cleanup

Unavailable simulators removed.

Deleted 4 unavailable simulator(s):
  - iPhone 13 (12345678-ABCD-EF01-2345-6789ABCDEF01) — iOS 16.4 (runtime not installed)
  - iPhone 13 mini (23456789-BCDE-F012-3456-789ABCDEF012) — iOS 16.4 (runtime not installed)
  - iPad mini (6th generation) (3456789A-CDEF-0123-4567-89ABCDEF0123) — iOS 16.2 (runtime not installed)
  - iPhone 12 (456789AB-DEF0-1234-5678-9ABCDEF01234) — iOS 15.5 (runtime not installed)

simulator_list — List simulators to find the UDID of the one you want to delete
simulator_shutdown — Shut down a simulator before deleting it
simulator_create — Create a new simulator to replace a deleted one
simulator_erase — Reset a simulator without deleting it entirely

Tips