Clone, build, and run agents with scorpiox
| Flag | Short | Description | Value |
|---|---|---|---|
| --branch | -b | — | Required |
| --cache-dir | — | Override agent cache directory | Required |
| --cwd | — | Working directory for the agent session | Required |
| --diag | — | all resolved paths and exit | Required |
| --diagnose | — | — | — |
| --dll | -d | — | Required |
| --dry-run | — | — | — |
| --force | — | rebuild even if cached | — |
| --help | -h | — | — |
| --id | -i | Task instance ID (default: auto-generated UUID) | Required |
| --list | -l | — | — |
| --model | -m | — | Required |
| --no-build | — | dotnet build step | — |
| --no-clone | -n | git clone step | — |
| --pat | -p | Personal access token for private repos | Required |
| --pipe-claude | — | CLAUDE.md content as stdin (default: off, uses system prompt) | — |
| --print-task-dir | — | task directory and exit (for SDK) | — |
| --prompt | — | — | Required |
| --provider | — | Provider (for --sdk mode) | Required |
| --repo | -r | — | Required |
| --sdk | — | mode: exec scorpiox-sdk --print instead of TUI | — |
| --session-id | — | Session ID (for --sdk mode) | Required |
| --sln | -s | — | Required |
| --task-dir-base | — | Override task instances base directory | Required |
| --tui | — | — | Required |
| -e | — | — | Required |