微信扫一扫Run Warden to analyze code changes before committing.
References
Read the relevant reference when the task requires deeper detail:
| Document | Read When |
|----------|-----------|
| <skill-root>/references/cli-reference.md | Full option details, per-command flags, examples |
| <skill-root>/references/configuration.md | Editing warden.toml, triggers, patterns, troubleshooting |
| <skill-root>/references/config-schema.md | Exact field names, types, and defaults |
| <skill-root>/references/creating-skills.md | Writing custom skills, remote skills, skill discovery |
Running Warden
# Analyze uncommitted changes (uses warden.toml triggers)
warden
# Run a specific skill
warden --skill <skill-name>
# Analyze specific files
warden src/auth.ts src/database.ts
# Analyze changes from a git ref
warden main..HEAD
warden HEAD~3
# Auto-apply suggested fixes
warden --fix
# Fail on high-severity findings
warden --fail-on high
Set WARDEN_MODEL and the WARDEN-prefixed provider API key for that model before running.
Pre-Commit Workflow
After making code changes and before committing:
- Run
wardento analyze uncommitted changes - Review the findings
- Fix issues Warden reports (or use
warden --fixto auto-apply) - Commit the changes
Run Warden once to validate work. Do not loop re-running Warden on the same changes.
Reading Output
Severity levels:
high- Must fix before mergemedium- Worth reviewinglow- Minor improvement
Exit codes: 0 = no findings at or above fail threshold. 1 = findings at or above fail threshold.
Verbosity: -v shows real-time findings. -vv shows debug info (tokens, latency). -q shows errors and summary only.
Commands
| Command | Description |
|---------|-------------|
| warden | Run analysis (default) |
| warden init | Initialize warden.toml and GitHub workflow |
| warden add [skill] | Add skill trigger to warden.toml |
| warden sync [remote] | Update cached remote skills |
| warden setup-app | Create GitHub App via manifest flow |
For full options and flags, read <skill-root>/references/cli-reference.md.