Skip to main content
Manage simulator runtimes - the OS versions that simulators can run.

flowdeck simulator runtime list

List installed simulator runtimes.
flowdeck simulator runtime list
flowdeck simulator runtime list --json

Options

OptionShortDescription
--json-jOutput as JSON

JSON Output

[
  {
    "identifier": "com.apple.CoreSimulator.SimRuntime.iOS-18-0",
    "name": "iOS 18.0",
    "version": "18.0",
    "isAvailable": true
  }
]

flowdeck simulator runtime create

Download and install a simulator runtime.
# Install latest iOS runtime
flowdeck simulator runtime create iOS

# Install specific version
flowdeck simulator runtime create iOS 18.0

# Install and prune auto-created simulators
flowdeck simulator runtime create iOS 18.0 --prune

Options

OptionShortDescription
<platform>Platform: iOS, tvOS, watchOS, or visionOS (required)
<version>Version (e.g., 18.0). Omit for latest
--verbose-vShow command output
--pruneRemove auto-created simulators after install
--json-jOutput as JSON
Installing a runtime can take several minutes depending on your internet connection. The runtime files are large (several GB).

flowdeck simulator runtime delete

Remove an installed simulator runtime.
# Delete by name
flowdeck simulator runtime delete "iOS 17.0"

# Delete by identifier
flowdeck simulator runtime delete com.apple.CoreSimulator.SimRuntime.iOS-17-0

Options

OptionShortDescription
<runtime>Runtime name (e.g., “iOS 17.2”) or runtime identifier (required)
--verbose-vShow command output
--json-jOutput as JSON
Deleting a runtime will make any simulators using that runtime unavailable. Make sure no simulators depend on it before deleting.

flowdeck simulator runtime prune

Delete all simulators associated with a specific runtime.
# Prune simulators for iOS 17.0
flowdeck simulator runtime prune "iOS 17.0"

# Preview what would be deleted
flowdeck simulator runtime prune "iOS 17.0" --dry-run

Options

OptionShortDescription
<runtime>Runtime name (e.g., “iOS 17.2”) or runtime identifier (required)
--dry-runShow what would be deleted without deleting
--verbose-vShow command output
--json-jOutput as JSON

flowdeck simulator device-types

List available simulator device types for creating new simulators.
flowdeck simulator device-types
flowdeck simulator device-types --json

Options

OptionShortDescription
--json-jOutput as JSON

JSON Output

[
  {
    "name": "iPhone 16 Pro",
    "identifier": "com.apple.CoreSimulator.SimDeviceType.iPhone-16-Pro"
  }
]