> ## 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.

# Management

> Create, clone, rename, delete, and maintain simulators

Commands for creating, cloning, renaming, 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 rename

Rename an existing simulator. The UDID stays the same; only the display name changes. Successful renames emit a simulator catalog-change wakeup so app destination pickers refresh.

```bash theme={null}
# Rename by current name
flowdeck simulator rename "iPhone 16" "My CI Device"

# Rename by UDID
flowdeck simulator rename A7D19B36-1234-5678-ABCD-123456789ABC "My iPhone"

# JSON output
flowdeck simulator rename "iPhone 16" "My CI Device" --json

# Inline examples
flowdeck simulator rename --examples
```

### Arguments

| Argument      | Description                    |
| ------------- | ------------------------------ |
| `<simulator>` | Current simulator UDID or name |
| `<new-name>`  | New display name               |

### Options

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

### JSON Output

```json theme={null}
{
  "success": true,
  "type": "simulator_rename",
  "udid": "A7D19B36-1234-5678-ABCD-123456789ABC",
  "name": "My CI Device"
}
```

***

## flowdeck simulator delete

Delete a simulator by UDID or name. The identifier argument is optional when `--unavailable` is used to bulk-delete every unavailable simulator at once.

```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 (identifier optional) |
| `--verbose`     | `-v`  | Show command output                                     |
| `--json`        | `-j`  | Output as JSON                                          |
| `--examples`    | `-e`  | Show usage examples                                     |

***

## flowdeck simulator prune

Delete simulators that have never been booted, have not been booted in 90+ days, or are unavailable.

```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 |