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

# Management

> Create, delete, and maintain simulators

Commands for creating, deleting, and maintaining simulators.

## flowdeck simulator create

Create a new simulator with a device type and runtime.

```bash theme={null}
flowdeck simulator create -n "My iPhone 16" --device-type "iPhone 16 Pro" --runtime "iOS 18.1"
```

### Options

| Option                 | Short | Description                           |
| ---------------------- | ----- | ------------------------------------- |
| `--name <name>`        | `-n`  | Name for the new simulator (required) |
| `--device-type <type>` |       | Device type (required)                |
| `--runtime <runtime>`  |       | Runtime (required)                    |
| `--verbose`            | `-v`  | Show command output                   |
| `--json`               | `-j`  | Output as JSON                        |
| `--examples`           | `-e`  | Show usage examples                   |

***

## flowdeck simulator clone

Clone an existing simulator, duplicating its settings and installed apps.

```bash theme={null}
flowdeck simulator clone "iPhone 16 Pro" -n "iPhone 16 Pro Copy"
flowdeck simulator clone A7D19B36-1234-5678-ABCD-123456789ABC -n "My Clone"
```

### Arguments

| Argument   | Description                   |
| ---------- | ----------------------------- |
| `<source>` | Source simulator UDID or name |

### Options

| Option          | Short | Description                              |
| --------------- | ----- | ---------------------------------------- |
| `--name <name>` | `-n`  | Name for the cloned simulator (required) |
| `--verbose`     | `-v`  | Show command output                      |
| `--json`        | `-j`  | Output as JSON                           |
| `--examples`    | `-e`  | Show usage examples                      |

***

## flowdeck simulator delete

Delete a simulator by UDID or name.

```bash theme={null}
flowdeck simulator delete <UDID>
flowdeck simulator delete "iPhone 16"
flowdeck simulator delete _ --unavailable
```

### Options

| Option          | Short | Description                       |
| --------------- | ----- | --------------------------------- |
| `--unavailable` |       | Delete all unavailable simulators |
| `--verbose`     | `-v`  | Show command output               |
| `--examples`    | `-e`  | Show usage examples               |

***

## flowdeck simulator prune

Delete unused simulators (never booted).

```bash theme={null}
flowdeck simulator prune --dry-run
flowdeck simulator prune
```

### Options

| Option       | Short | Description                                 |
| ------------ | ----- | ------------------------------------------- |
| `--dry-run`  |       | Show what would be deleted without deleting |
| `--verbose`  | `-v`  | Show verbose output                         |
| `--json`     | `-j`  | Output as JSON                              |
| `--examples` | `-e`  | Show usage examples                         |

***

## flowdeck simulator erase

Erase all content and settings from a simulator.

```bash theme={null}
flowdeck simulator erase <UDID>
flowdeck simulator erase <UDID> --json
```

### Options

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

<Note>
  If the target simulator is booted, FlowDeck shuts it down, erases it, and boots it again automatically.
</Note>

***

## flowdeck simulator clear-cache

Clear simulator caches.

```bash theme={null}
flowdeck simulator clear-cache
flowdeck simulator clear-cache --verbose
flowdeck simulator clear-cache --json
```

### Options

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

***

## flowdeck simulator device-types

List available simulator device types.

```bash theme={null}
flowdeck simulator device-types
flowdeck simulator device-types --json
```

### Options

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