Configuration

⚙️ Configuration

🌐 Environment Variables

All configuration can be set via environment variables prefixed with CODEGENESIS_:

export CODEGENESIS_Claude__CliPath="/usr/local/bin/claude"
export CODEGENESIS_Claude__DefaultModel="claude-sonnet-4-6"
export CODEGENESIS_Claude__TimeoutSeconds=600

---

📄 appsettings.json

Place an appsettings.json in the Engine project for persistent configuration:

{
  "Claude": {
    "CliPath": "claude",
    "DefaultModel": "claude-sonnet-4-6",
    "TimeoutSeconds": 300,
    "MaxTurnsDefault": 5
  }
}

Key	Default	Description
CliPath	"claude"	Path to the Claude Code CLI binary
DefaultModel	null	Model used when none is specified
TimeoutSeconds	300	Max seconds before killing a process
MaxTurnsDefault	5	Default agentic turns per step (0 = unlimited)

---

🔢 Priority Order

Configuration values are resolved in this order (most specific wins):

graph LR
    A["CLI flags<br/>(--model, --max-turns)"] --> B["Step YAML<br/>(per-step config)"]
    B --> C["Pipeline YAML<br/>(settings section)"]
    C --> D["appsettings.json"]
    D --> E["Environment variables"]
    style A fill:#2d5016,color:#fff

Loading

---

📋 Logs

Logs are written to the logs/ directory with daily rolling files:

logs/codegenesis-20260225.log

Detail	Value
Log level	Debug
Format	Timestamped structured logs
Contents	Claude process invocations, exit codes, durations, errors
Rotation	Daily rolling files

Tip

Check the logs when a step fails unexpectedly — they include the full Claude CLI invocation and raw output.