Installation

Install via npm (recommended), Scoop, or Homebrew. All methods download a compiled binary and run the interactive setup wizard.

npm (recommended)

npx @bitmilldev/warden init

Scoop (Windows)

scoop bucket add warden https://github.com/ekud12/scoop-warden
scoop install warden

Homebrew (macOS / Linux)

brew install ekud12/warden/warden

What init Does

The init wizard walks you through:

• Creating the ~/.warden/ directory structure
• Installing Warden to your PATH
• Detecting and optionally installing CLI tools (rg, fd, bat, etc.)
• Configuring hooks for your AI assistant
• Writing default configuration
• Starting the background server

Connect to Your Assistant

After installation, connect Warden to your AI assistant:

# For Claude Code
warden install claude-code

# For Gemini CLI
warden install gemini-cli

# For Codex CLI
warden install codex-cli

That’s it. Start a coding session and Warden activates automatically via hooks. No commands to run, no config to write.

Verify Installation

You can verify everything is working:

warden doctor

This checks that Warden is on PATH, the server is reachable, hooks are registered, and your AI assistant is configured correctly.

Once verified, start a coding session. Warden activates automatically — no commands to run, no config to write. If something isn’t working, see Troubleshooting.

Coming Soon