| api-key | API key for devicecloud.dev (find this in the console UI). You can also set the DEVICE_CLOUD_API_KEY environment variable. | yes | — |
| api-url | API URL for devicecloud.dev | no | — |
| app-file | App binary to run your flows against | no | — |
| app-binary-id | The ID of the app binary previously uploaded to devicecloud.dev | no | — |
| android-api-level | [Android only] Android API level to run your flow against <options: 29|30|31|32|33|34|35|36> | no | — |
| android-device | [Android only] Android device to run your flow against <options: pixel-6|pixel-6-pro|pixel-7|pixel-7-pro|generic-tablet> | no | — |
| async | Immediately return (exit code 0) from the command without waiting for the results of the run (useful for saving CI minutes) | no | — |
| device-locale | Locale that will be set to a device, ISO-639-1 code and uppercase ISO-3166-1 code e.g. "de_DE" for Germany | no | — |
| download-artifacts | Download a zip containing the logs, screenshots and videos for each result in this run. You will debited a $0.01 egress fee for each result. Use FAILED for failures only or ALL for every result. <options: ALL|FAILED> | no | — |
| env | One or more environment variables to inject into your flows | no | — |
| json-file | Write JSON output to a file with name <run_name>_dcd.json or <upload_id>_dcd.json if no name is provided | no | — |
| exclude-flows | Sub directories to ignore when building the flow file list | no | — |
| exclude-tags | Flows which have these tags will be excluded from the run | no | — |
| flows | The path to the flow file or folder containing your flows | no | — |
| google-play | [Android only] Run your flow against Google Play devices | no | — |
| ignore-sha-check | Ignore the sha hash check and upload the binary regardless of whether it already exists (not recommended) | no | — |
| include-tags | Only flows which have these tags will be included in the run | no | — |
| ios-device | [iOS only] iOS device to run your flow against <options: iphone-14|iphone-14-pro|iphone-15|iphone-15-pro|iphone-16|iphone-16-plus|iphone-16-pro|iphone-16-pro-max|ipad-pro-6th-gen> | no | — |
| ios-version | [iOS only] iOS version to run your flow against <options: 16|17|18|26> | no | — |
| maestro-version | Maestro version to run your flow against | no | — |
| moropo-v1-api-key | API key for Moropo v1 integration | no | — |
| name | A custom name for your upload (useful for tagging commits etc) | no | — |
| orientation | [Android only] The orientation of the device to run your flow against in degrees <options: 0|90|180|270> | no | — |
| quiet | Quieter console output that wont provide progress updates | no | — |
| report | Runs Maestro with the --format flag, this will generate a report in the specified format <options: junit|html|html-detailed> | no | — |
| retry | Number of times to retry the run if it fails (same as pressing retry in the UI, this is free) | no | — |
| workspace | The path to the workspace folder containing your flows | no | ./.maestro/ |
| config | Specific path to your maestro config file | no | — |
| runner-type | [experimental] The type of runner to use <options: m1|m4> - note: anything other than default will incur premium pricing tiers. See https://docs.devicecloud.dev/reference/runner-type for more information | no | default |
| debug | Enable debug mode for more verbose output | no | — |
| use-beta | Use the beta version of the DCD CLI instead of the latest stable version | no | — |
| maestro-chrome-onboarding | [Android only] Force Maestro-based Chrome onboarding - note: this will slow your tests but can fix browser related crashes. See https://docs.devicecloud.dev/reference/chrome-onboarding for more information. | no | — |
| android-no-snapshot | [Android only] Force cold boot instead of using snapshot boot. This is automatically enabled for API 35+ but can be used to force cold boot on older API levels. | no | — |
| disable-animations | Disable device animations during test execution. On Android, disables system animation scales. On iOS, enables Reduce Motion. Reduces CPU load and may improve test reliability. | no | — |
| include-github-context | Automatically attach GitHub/PR context (branch, SHA, PR number, PR URL, run ID, repo) to the test run as metadata. Set to "false" to opt out. | no | true |