CLI Reference

💻 CLI Reference

run <task>

Runs a built-in Plan → Execute → Validate pipeline for a given task description.

dotnet run --project CodeGenesis.Engine -- run "Add retry logic to the HttpClient service"

Options

Option	Description	Default
-d, --directory	Working directory	current
-m, --model	Claude model (e.g. claude-sonnet-4-6)	from config
--max-turns	Max agentic turns per step	5
--skip-validate	Skip the validation step	false

Examples

# Simple task
dotnet run --project CodeGenesis.Engine -- run "Fix the login bug"

# With model override and unlimited turns
dotnet run --project CodeGenesis.Engine -- run "Build a full REST API" \
  --model claude-opus-4-6 --max-turns 0

# Skip validation step
dotnet run --project CodeGenesis.Engine -- run "Refactor auth module" --skip-validate

---

run-pipeline <file>

Runs a pipeline defined in a YAML configuration file.

dotnet run --project CodeGenesis.Engine -- run-pipeline examples/hello-world.yml

Options

Option	Description	Default
-i, --input	Input override as key=value (repeatable)	—
-d, --directory	Working directory	current
-m, --model	Model override for all steps	from config
--resume	Resume from last checkpoint (skips completed steps)	false
--from-step <STEP>	Resume from a specific step name	—

Examples

# Basic pipeline
dotnet run --project CodeGenesis.Engine -- run-pipeline pipeline.yml

# With input overrides
dotnet run --project CodeGenesis.Engine -- run-pipeline pipeline.yml \
  --input task="Create a Python calculator" \
  --input language="python"

# With model override
dotnet run --project CodeGenesis.Engine -- run-pipeline pipeline.yml \
  --model claude-sonnet-4-6

# Resume from last checkpoint
dotnet run --project CodeGenesis.Engine -- run-pipeline pipeline.yml --resume

# Resume from a specific step
dotnet run --project CodeGenesis.Engine -- run-pipeline pipeline.yml --from-step "Execute"

Note

--resume and --from-step are mutually exclusive. Checkpoints are saved automatically after each step completes. If the YAML file changed since the checkpoint, a warning is shown.

Tip

See Pipeline YAML Reference for the full YAML configuration format.