> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flowdeck.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Runtimes

> Manage installed simulator runtimes

Runtimes are the platform images (iOS, tvOS, watchOS, visionOS) used by simulators.

```bash theme={null}
# Show runtime command examples
flowdeck simulator runtime --examples
```

## flowdeck simulator runtime list

List installed runtimes.

```bash theme={null}
flowdeck simulator runtime list
flowdeck simulator runtime list --json
```

### Options

| Option       | Short | Description         |
| ------------ | ----- | ------------------- |
| `--json`     | `-j`  | Output as JSON      |
| `--examples` | `-e`  | Show usage examples |

***

## flowdeck simulator runtime available

List downloadable runtimes from Apple.

```bash theme={null}
flowdeck simulator runtime available
flowdeck simulator runtime available --platform iOS
flowdeck simulator runtime available --json
flowdeck simulator runtime available --examples
```

### Options

| Option              | Short | Description                                       |
| ------------------- | ----- | ------------------------------------------------- |
| `--platform <name>` | `-P`  | Filter by platform (iOS, tvOS, watchOS, visionOS) |
| `--json`            | `-j`  | Output as JSON                                    |
| `--examples`        | `-e`  | Show usage examples                               |

***

## flowdeck simulator runtime install

Download and install a runtime. Also available as `flowdeck simulator runtime create` (the two are aliases for the same command).

```bash theme={null}
flowdeck simulator runtime install iOS 18.1
flowdeck simulator runtime install iOS --prune
flowdeck simulator runtime create iOS 18.1    # Same as 'install'
```

### Options

| Option       | Short | Description                                  |
| ------------ | ----- | -------------------------------------------- |
| `--verbose`  | `-v`  | Show command output                          |
| `--prune`    |       | Remove auto-created simulators after install |
| `--json`     | `-j`  | Output as JSON                               |
| `--examples` | `-e`  | Show usage examples                          |

***

## flowdeck simulator runtime delete

Remove an installed runtime.

```bash theme={null}
flowdeck simulator runtime delete "iOS 17.2"
```

### Options

| Option       | Short | Description         |
| ------------ | ----- | ------------------- |
| `--verbose`  | `-v`  | Show command output |
| `--json`     | `-j`  | Output as JSON      |
| `--examples` | `-e`  | Show usage examples |

***

## flowdeck simulator runtime prune

Delete simulators for a runtime.

```bash theme={null}
flowdeck simulator runtime prune "iOS 18.0"
```

### Options

| Option       | Short | Description                  |
| ------------ | ----- | ---------------------------- |
| `--verbose`  | `-v`  | Show deleted simulator UDIDs |
| `--json`     | `-j`  | Output as JSON               |
| `--examples` | `-e`  | Show usage examples          |

***

## flowdeck simulator update

Upgrade an existing simulator to a newer runtime in place. The target runtime must already be installed (see `runtime install`).

```bash theme={null}
flowdeck simulator update "iOS 18.4"
flowdeck simulator update "iOS 18.4" -S "iPhone 16"
flowdeck simulator update com.apple.CoreSimulator.SimRuntime.iOS-18-4 --json
```

### Options

| Option              | Short | Description                                               |
| ------------------- | ----- | --------------------------------------------------------- |
| `--simulator <sim>` | `-S`  | Simulator name or UDID (defaults to the booted simulator) |
| `--verbose`         | `-v`  | Show command output                                       |
| `--json`            | `-j`  | Output as JSON                                            |
| `--examples`        | `-e`  | Show usage examples                                       |