# uip rpa-legacy debug

> Syntax and options for `uip rpa-legacy debug`, which executes a XAML workflow locally via UiRobot with real-time log streaming.

`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](./uip-rpa-legacy.md) warning.

## Synopsis

```
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

```bash
# 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`](./uip-rpa-legacy-validate.md) — validate before debugging to catch compile errors first.
- [`uip rpa-legacy package`](./uip-rpa-legacy-package.md) — pack the project once it runs cleanly.
- [`uip rpa run-file`](./uip-rpa-run-file.md) — cross-platform workflow runner; prefer it for non-legacy projects.
- [`uip rpa-legacy`](./uip-rpa-legacy.md) — tool overview.

## See also

- [Global options](./global-options.md)
- [Exit codes](./exit-codes.md)