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

# Listing

> List available simulators

List available simulators, grouped by platform and OS version.

```bash theme={null}
# List all simulators
flowdeck simulator list

# Filter by platform
flowdeck simulator list -P iOS
flowdeck simulator list --platform iOS

# Show only available simulators
flowdeck simulator list -A
flowdeck simulator list --available-only

# JSON output
flowdeck simulator list --json

# Show usage examples
flowdeck simulator list --examples
```

## Options

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

## JSON Output

```json theme={null}
[
  {
    "udid": "12345678-1234-1234-1234-123456789ABC",
    "name": "iPhone 16 Pro",
    "platform": "iOS",
    "osVersion": "18.0",
    "state": "Shutdown",
    "isAvailable": true,
    "deviceTypeIdentifier": "com.apple.CoreSimulator.SimDeviceType.iPhone-16-Pro",
    "runtimeIdentifier": "com.apple.CoreSimulator.SimRuntime.iOS-18-0"
  }
]
```