uipath-cli
latest
false
- Overview
- Get started
- Concepts
- Using UiPath CLI
- How-to guides
- CI/CD recipes
- Command reference
- Overview
- Exit codes
- Global options
- uip codedagent
- uip docsai
- add-test-data-entity
- add-test-data-queue
- add-test-data-variation
- analyze
- build
- create-project
- diff
- find-activities
- get-analyzer-rules
- get-default-activity-xaml
- get-errors
- get-manual-test-cases
- get-manual-test-steps
- get-versions
- get-workflow-example
- indicate-application
- indicate-element
- inspect-package
- install-data-fabric-entities
- install-or-update-packages
- list-data-fabric-entities
- list-workflow-examples
- pack
- restore
- run-file
- search-templates
- start-studio
- stop-execution
- uia
- uip traces
- Migration
- Reference & support
UiPath CLI user guide
Last updated May 7, 2026
uip rpa-legacy debug executes a XAML workflow locally via UiRobot. It streams logs in real time and returns structured output arguments on success, or error details on failure. Requires UiRobot installed on the local machine — by default the verb auto-detects UiRobot.exe; pass --robot-path to override.
Windows-only — see the overview warning.
Synopsis
uip rpa-legacy debug <xaml-path> [options]
uip rpa-legacy debug <xaml-path> [options]
<xaml-path>(required) — Path to the XAML workflow file to execute.
Options
| Flag | Description |
|---|---|
-i, --input <json> | Input arguments as a JSON string. |
--result-path <path> | Write structured execution result (output args or error details) to a JSON file. |
--timeout <seconds> | Execution timeout in seconds (0 = no timeout). |
--robot-path <path> | Path to UiRobot.exe (auto-detected if not provided). |
Examples
# Run a workflow with no input
uip rpa-legacy debug ./MyProject/Main.xaml
# Pass input arguments inline and write the result to a file
uip rpa-legacy debug ./MyProject/Main.xaml \
--input '{"invoicePath":"C:/data/inv.pdf"}' \
--result-path ./run-result.json
# Use an explicit UiRobot path with a 5-minute timeout
uip rpa-legacy debug ./MyProject/Main.xaml \
--robot-path "C:/Program Files/UiPath/Studio/UiRobot.exe" \
--timeout 300
# Run a workflow with no input
uip rpa-legacy debug ./MyProject/Main.xaml
# Pass input arguments inline and write the result to a file
uip rpa-legacy debug ./MyProject/Main.xaml \
--input '{"invoicePath":"C:/data/inv.pdf"}' \
--result-path ./run-result.json
# Use an explicit UiRobot path with a 5-minute timeout
uip rpa-legacy debug ./MyProject/Main.xaml \
--robot-path "C:/Program Files/UiPath/Studio/UiRobot.exe" \
--timeout 300
Related
uip rpa-legacy validate— validate before debugging to catch compile errors first.uip rpa-legacy package— pack the project once it runs cleanly.uip rpa run-file— cross-platform workflow runner; prefer it for non-legacy projects.uip rpa-legacy— tool overview.