CLI

The Warden CLI reviews local changes, manages skills, and helps configure GitHub integration.

warden [targets...] [options]

If no command is given, Warden runs the default analysis command. With no target, it reviews the current branch against the default branch.

Commands

warden runAnalyze files, git refs, or current branch changes.warden initCreate config and GitHub workflow files.warden addAdd built-in, remote, or local skills.warden syncRefresh cached remote skills.warden buildCreate or refresh a generated skill.warden improveRevise an existing generated skill from feedback.warden runsInspect saved sessions and run logs.warden setup-appCreate a GitHub App for branded comments.

Global Options

These options are available at the root CLI level. Command-specific options are documented on each command page.

Option	Purpose
-C, --cwd <path>	Run as if invoked from this directory.
-h, --help	Show help for a command.
-V, --version	Show version number.

Common Examples

warden                     # Review current branch changes
warden src/auth.ts         # Analyze a specific file
warden src/api/            # Analyze a directory
warden @targets.txt        # Analyze targets listed in a file
warden --staged            # Analyze staged changes
warden HEAD~3..HEAD        # Analyze changes in a git range
warden help add            # Show command help

Source of Truth

The CLI help text is defined in src/cli/help.ts. This reference mirrors that structured command metadata. If the CLI changes, update the help spec first and then update these pages from it.