Configuration

Warden is configured with warden.toml in your repository root. This reference covers warden.toml only. GitHub Actions workflow settings live under GitHub Workflow.

warden.toml

version = 1

[[skills]]
name = "security-review"

[[skills.triggers]]
type = "pull_request"
actions = ["opened", "synchronize"]

[[skills]]
name = "code-review"

[[skills.triggers]]
type = "pull_request"
actions = ["opened", "synchronize"]

Sections

Skill EntriesSkill fields, filters, remotes, and model overrides.TriggersPull request, local, and schedule trigger settings.Output and DefaultsFailure thresholds, report thresholds, and defaults.RunnerRun-level concurrency for CLI and action executions.ChunkingControl whether Warden analyzes hunks, whole files, or skips files.

Environment Variables

Variable	Purpose
WARDEN_MODEL	Pi model selector, such as openai/gpt-5.5 or anthropic/claude-sonnet-4-6.
WARDEN_OPENAI_API_KEY	OpenAI API key when using an OpenAI Pi model.
WARDEN_ANTHROPIC_API_KEY	Anthropic API key when using an Anthropic Pi model or the Claude runtime.
WARDEN_SKILL_CACHE_TTL	Cache duration for unpinned remote skills. Default: 24h.