FlowDeck provides comprehensive physical device management via USB and WiFi. Alias: dev
flowdeck device list
List connected physical devices.
# List all connected devices
flowdeck device list
# Filter by platform
flowdeck device list --platform iOS
# Show only available devices
flowdeck device list --available-only
# JSON output
flowdeck device list --json
Options
| Option | Short | Description |
|---|
--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
[
{
"udid": "00008030-001234567890ABCD",
"name": "John's iPhone",
"platform": "iOS",
"osVersion": "18.1",
"deviceType": "iPhone 16 Pro",
"connectionType": "USB",
"isAvailable": true
}
]
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 |
JSON Output
{
"success": true,
"message": "App installed successfully",
"udid": "00008030-001234567890ABCD",
"appPath": "/path/to/MyApp.app"
}
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 |
JSON Output
{
"success": true,
"message": "App uninstalled successfully",
"udid": "00008030-001234567890ABCD",
"bundleId": "com.example.MyApp"
}
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 |
JSON Output
{
"success": true,
"message": "App launched successfully",
"udid": "00008030-001234567890ABCD",
"bundleId": "com.example.MyApp"
}
Use flowdeck device list --json to get the device UDID needed for install, uninstall, and launch commands.
