Clone, build, and run agents with scorpiox. Fetches agent repos, compiles .NET solutions, and launches interactive or SDK-mode sessions.
| Flag | Short | Description | Takes Value |
|---|---|---|---|
--repo |
-r |
Git repository URL (default: from AGENTS_REPO_URL env) | Yes |
--branch |
-b |
Git branch (default: main) | Yes |
--sln |
-s |
Solution file path (auto-detected if not specified) | Yes |
--dll |
-d |
DLL name (inferred from sln if not specified) | Yes |
--list |
-l |
List available agents and exit | No |
--dry-run |
-n |
Clone and build, but skip launching scorpiox | No |
--prompt |
-p |
Extra text to append after CLAUDE.md | Yes |
--model |
-m |
Model: haiku, opus, sonnet (passed to scorpiox) | Yes |
--id |
— |
Task instance ID (default: auto-generated UUID) | Yes |
--pat |
— |
Personal access token for private repos | Yes |
--cwd |
— |
Working directory for the agent session | Yes |
--no-clone |
— |
Skip git clone (use existing source) | No |
--no-build |
— |
Skip dotnet build (use existing binaries) | No |
--force |
— |
Force rebuild even if cached | Yes |
--diag |
— |
Print all resolved paths and exit (diagnostic mode) | No |
--print-task-dir |
— |
Print task directory and exit (machine-readable) | Yes |
--cache-dir |
— |
Override agent cache base directory | Yes |
--sdk |
— |
SDK mode: exec scorpiox-sdk --print instead of TUI | No |
--session-id |
— |
Session ID (passed to scorpiox-sdk in --sdk mode) | Yes |
--provider |
— |
Provider (passed to scorpiox-sdk in --sdk mode) | Yes |
--task-dir-base |
— |
Override task instances base directory | Yes |
--tui |
-i |
Launch in TUI interactive mode | Yes |
--help |
-h |
Show help | No |