Management

Commands for creating, cloning, renaming, deleting, and maintaining simulators.

flowdeck simulator create

Create a new simulator with a device type and runtime.

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.

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.

# 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

{
  "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.

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.

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.

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

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

flowdeck simulator clear-cache

Clear simulator caches.

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.

flowdeck simulator device-types
flowdeck simulator device-types --json

Options

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

Overview

FlowDeck for AI

Interactive Mode (TUI)

Core Features

Command Reference

Advanced

Support

flowdeck simulator create

Options

flowdeck simulator clone

Arguments

Options

flowdeck simulator rename

Arguments

Options

JSON Output

flowdeck simulator delete

Options

flowdeck simulator prune

Options

flowdeck simulator erase

Options

flowdeck simulator clear-cache

Options

flowdeck simulator device-types

Options

​flowdeck simulator create

​Options

​flowdeck simulator clone

​Arguments

​Options

​flowdeck simulator rename

​Arguments

​Options

​JSON Output

​flowdeck simulator delete

​Options

​flowdeck simulator prune

​Options

​flowdeck simulator erase

​Options

​flowdeck simulator clear-cache

​Options

​flowdeck simulator device-types

​Options

flowdeck simulator create

Options

flowdeck simulator clone

Arguments

Options

flowdeck simulator rename

Arguments

Options

JSON Output

flowdeck simulator delete

Options

flowdeck simulator prune

Options

flowdeck simulator erase

Options

flowdeck simulator clear-cache

Options

flowdeck simulator device-types

Options