Skip to main content

​
What is Warden?

Warden is an event-driven code analysis agent that reviews your code using Claude-powered skills. It runs locally via CLI or automatically on every pull request through GitHub Actions. Unlike traditional linters that run predefined rules, Warden uses Claude to perform sophisticated code analysis through modular “skills” - reusable agents that can detect bugs, review architecture, check security vulnerabilities, and more.

​
Why Warden?

Skills, not prompts

Define analysis once, run it anywhere. Skills are shareable, version-controlled agents that follow the agentskills.io specification.

Two ways to run

CLI catches issues before you push. GitHub Action reviews every PR automatically.

GitHub-native

Findings appear as inline PR comments with suggested fixes that can be applied automatically.

Cost tracking

Built-in usage tracking shows exactly how much each skill run costs.

​
Core Concepts

Skills

Claude-powered code analysis agents that detect issues in your codebase

Triggers

Event-driven conditions that determine when skills run

Findings

Issues detected by skills with severity, confidence, and suggested fixes

Configuration

TOML-based configuration for skills, triggers, and runtime behavior

​
How It Works

1

Configure skills in warden.toml

Define which skills to run, when they trigger, and how they behave:
warden.toml
version = 1

[defaults]
failOn = "high"
reportOn = "medium"

[[skills]]
name = "find-bugs"
paths = ["src/**/*.ts"]

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

Run Warden locally or in CI

Execute Warden via CLI or GitHub Action:
# Run on uncommitted changes
npx warden

# Run on specific files
npx warden src/api/

# Fix issues automatically
npx warden --fix
3

Review findings

Warden analyzes your code with Claude and reports findings:
  • CLI: Terminal output with colors and severity badges
  • GitHub: Inline PR comments with suggested fixes
  • JSON/JSONL: Machine-readable output for integration
4

Apply fixes

Accept suggested fixes automatically or review them first:
# Interactive fix mode
npx warden --fix

# Apply all fixes automatically
npx warden --fix --yes

​
Use Cases

​
Bug Detection

Catch bugs before they reach production with skills that understand your codebase’s patterns and anti-patterns.
warden.toml
[[skills]]
name = "find-bugs"
paths = ["src/**/*.ts"]
ignorePaths = ["**/*.test.ts"]

​
Architecture Review

Enforce architectural patterns and detect violations across your codebase.
warden.toml
[[skills]]
name = "architecture-review"
paths = ["src/**/*.ts"]
failOn = "medium"

​
Security Scanning

Detect security vulnerabilities and common attack vectors with schedule-based scanning.
warden.toml
[[skills]]
name = "security-audit"

[[skills.triggers]]
type = "schedule"

[skills.triggers.schedule]
createFixPR = true

​
Code Quality

Maintain code quality standards with custom skills tailored to your team’s conventions.
warden.toml
[[skills]]
name = "code-quality"
reportOn = "low"
reportOnSuccess = true

​
Next Steps

Quickstart

Get up and running in 5 minutes

Installation

Install Warden and set up authentication

CLI Commands

Learn all CLI commands and options

Create Skills

Write your own custom analysis skills

Build docs developers (and LLMs) love

Get started for freeTalk to us