FlowDeck provides physical device management via USB and WiFi. Alias: dev.
flowdeck device list
List connected physical devices (and virtual macOS targets).
# List all connected devices
flowdeck device list
# Filter by platform
flowdeck device list -P iOS
flowdeck device list --platform iOS
# Show only available devices
flowdeck device list -A
flowdeck device list --available-only
# JSON output
flowdeck device list --json
# Show usage examples
flowdeck device list --examples
Options
| Option | Short | Description |
|---|
--examples | -e | Show usage examples |
--platform <name> | -P | Filter by platform: iOS, iPadOS, watchOS, tvOS, visionOS |
--available-only | -A | Show only available devices |
--json | -j | Output as JSON |
JSON Output
[
{
"name": "My Mac",
"platform": "macOS",
"isAvailable": true,
"isVirtual": true,
"description": "Build and run as native macOS app"
},
{
"name": "My Mac Catalyst",
"platform": "macOS",
"isAvailable": true,
"isVirtual": true,
"description": "Build and run iOS app via Mac Catalyst"
},
{
"udid": "00008030-001234567890ABCD",
"name": "John's iPhone",
"platform": "iOS",
"osVersion": "18.1",
"deviceType": "iPhone 16 Pro",
"connectionType": "USB",
"isAvailable": true,
"isVirtual": false
}
]
flowdeck device install
Install an app bundle (.app) on a physical device.
# Install app on device
flowdeck device install <UDID> /path/to/MyApp.app
# Install with verbose output
flowdeck device install <UDID> /path/to/MyApp.app --verbose
# Install with JSON output
flowdeck device install <UDID> /path/to/MyApp.app --json
Options
| Option | Short | Description |
|---|
--verbose | -v | Show command output |
--json | -j | Output as JSON |
--examples | -e | Show usage examples |
flowdeck device uninstall
Remove an installed app from a physical device.
# Uninstall app from device
flowdeck device uninstall <UDID> com.example.MyApp
# Uninstall with verbose output
flowdeck device uninstall <UDID> com.example.MyApp --verbose
# Uninstall with JSON output
flowdeck device uninstall <UDID> com.example.MyApp --json
Options
| Option | Short | Description |
|---|
--verbose | -v | Show command output |
--json | -j | Output as JSON |
--examples | -e | Show usage examples |
flowdeck device launch
Launch an installed app on a physical device.
# Launch app on device
flowdeck device launch <UDID> com.example.MyApp
# Launch with verbose output
flowdeck device launch <UDID> com.example.MyApp --verbose
# Launch with JSON output
flowdeck device launch <UDID> com.example.MyApp --json
Options
| Option | Short | Description |
|---|
--verbose | -v | Show command output |
--json | -j | Output as JSON |
--examples | -e | Show usage examples |
Use flowdeck device list --json to get device UDIDs.
