Manage simulator platforms (runtimes) for iOS, tvOS, watchOS, and visionOS. Alias: plat
List installed simulator runtimes.
flowdeck platform list
flowdeck platform list --json
Options
| Option | Short | Description |
|---|
--json | -j | Output as JSON |
JSON Output
[
{
"name": "iOS 18.1",
"version": "18.1",
"build": "22B83",
"identifier": "com.apple.CoreSimulator.SimRuntime.iOS-18-1",
"isAvailable": true,
"platform": "iOS"
}
]
List downloadable simulator runtimes from Apple.
# List all available runtimes
flowdeck platform available
# Filter by platform
flowdeck platform available --platform iOS
# JSON output
flowdeck platform available --json
Options
| Option | Short | Description |
|---|
--platform <name> | -P | Filter by platform (iOS, tvOS, watchOS, visionOS) |
--json | -j | Output as JSON |
JSON Output
[
{
"name": "iOS 18.1",
"version": "18.1",
"build": "22B83",
"platform": "iOS",
"fileSize": 7516192768,
"fileSizeFormatted": "7.0 GB"
}
]
Download and install a simulator platform.
# Install latest iOS
flowdeck platform install iOS
# Install specific version
flowdeck platform install iOS 17.2
# Install and prune auto-created simulators
flowdeck platform install iOS 18.1 --prune
Options
| Option | Short | Description |
|---|
--verbose | -v | Show command output |
--prune | | Remove auto-created simulators after install |
--json | -j | Output as JSON |
JSON Output
{
"success": true,
"message": "Platform installed successfully",
"platform": "iOS",
"version": "18.1",
"prunedDevices": 5
}
Remove an installed simulator runtime.
# Remove by name
flowdeck platform remove "iOS 17.2"
# Remove by identifier
flowdeck platform remove com.apple.CoreSimulator.SimRuntime.iOS-17-2
Options
| Option | Short | Description |
|---|
--verbose | -v | Show command output |
--json | -j | Output as JSON |
Delete auto-created simulators for a specific runtime.
# Delete simulators for a runtime
flowdeck platform prune "iOS 18.1"
# Show what would be deleted
flowdeck platform prune "iOS 18.1" --verbose
Options
| Option | Short | Description |
|---|
--verbose | -v | Show deleted simulator UDIDs |
--json | -j | Output as JSON |
Xcode Commands
Manage Xcode application and related caches. Alias: xc
flowdeck xcode open
Open Xcode with the workspace or project in the current directory.
# Open Xcode with auto-detected project
flowdeck xcode open
# Open specific workspace or project
flowdeck xcode open --path MyApp.xcworkspace
Options
| Option | Short | Description |
|---|
--path <path> | | Path to workspace or project (defaults to auto-detect) |
--json | -j | Output as JSON |
flowdeck xcode clean-derived-data
Delete the entire Xcode Derived Data folder. This is the “nuclear option” for fixing build issues.
flowdeck xcode clean-derived-data
flowdeck xcode clean-derived-data --json
Options
| Option | Short | Description |
|---|
--json | -j | Output as JSON |
When to Use
- Build errors that don’t make sense
- After changing build settings
- After switching branches with different dependencies
- When disk space is running low
flowdeck xcode clean-cache
Delete the Xcode cache folder to fix indexing and autocomplete issues.
flowdeck xcode clean-cache
flowdeck xcode clean-cache --json
Options
| Option | Short | Description |
|---|
--json | -j | Output as JSON |
When to Use
- Xcode autocomplete is broken or slow
- SourceKit keeps crashing
- Indexing seems stuck or incorrect
- After updating Xcode
License Commands
flowdeck license status
Check current license status.
flowdeck license status
flowdeck license status --json
Options
| Option | Short | Description |
|---|
--json | -j | Output as JSON |
flowdeck license activate
Activate a license on this machine.
flowdeck license activate YOUR-LICENSE-KEY
flowdeck license deactivate
Deactivate license from this machine.
flowdeck license deactivate
For CI/CD environments, set the FLOWDECK_LICENSE_KEY environment variable instead of activating. This avoids consuming activation slots.
Update Commands
flowdeck update
Check for FlowDeck updates.
# Check for updates
flowdeck update
# Force check (ignore cache)
flowdeck update --check
# JSON output
flowdeck update --json
Options
| Option | Short | Description |
|---|
--check | | Force check (ignore cache) |
--json | -j | Output as JSON |
To update FlowDeck, run flowdeck update or reinstall with:curl -sSL https://flowdeck.studio/install.sh | sh
Changelog Commands
flowdeck changelog
Display the FlowDeck CLI changelog, showing the last 10 releases.
# Show all recent changes
flowdeck changelog
# Show changes for a specific version
flowdeck changelog --release 1.2.0
# JSON output
flowdeck changelog --json
Options
| Option | Short | Description |
|---|
--release <version> | -r | Show changes for a specific version (e.g., 1.2.0) |
--json | -j | Output as JSON |
Example Output
FlowDeck Changelog
========================================
Version 1.2.0 (2025-12-20)
----------------------------------------
- Improved --help documentation and examples
Version 1.1.5 (2025-12-20)
----------------------------------------
- Add --dry-run flag to all commands for validation without execution
- Add --device option to build and run commands for physical device support
JSON Output
{
"success": true,
"releases": [
{
"version": "1.2.0",
"date": "2025-12-20",
"changes": [
"Improved --help documentation and examples"
]
}
]
}
If the specified version is not found, an error is returned with the list of available versions.
