refactoring

Two commands. That's it.

```bash

# 1. Install the CLI

curl -fsSL https://han.guru/install.sh | bash

# 2. Auto-detect and install plugins for your project

han plugin install --auto

```

Next time you use Claude Code, validation hooks run automatically when you finish a conversation.

Alternative Installation

```bash

# Homebrew (macOS/Linux)

brew install thebushidocollective/tap/han

```

1. Install - One command installs the CLI and auto-detects plugins for your stack
2. Code - Claude writes code as usual. No workflow changes needed
3. Validate - Stop hooks run automatically. Linters, formatters, type checkers, and tests are all verified
4. Learn - Local metrics track success rates and calibrate confidence. Nothing leaves your machine

139 plugins across four categories:

| Category | Description | Examples |

|----------|-------------|----------|

| Core | Essential infrastructure. Auto-installs han binary, provides metrics and MCP servers | Always required |

| Jutsu (Tools) | Validation plugins for your stack | TypeScript, Biome, Pytest, RSpec, ShellCheck |

| Dō (Agents) | Specialized AI agents | Code review, debugging, architecture, security |

| Hashi (Integrations) | MCP servers for external tools | GitHub, Playwright, Blueprints |

Browse all plugins at [han.guru/plugins](https://han.guru/plugins/)

• Smart Caching - Only runs validation when relevant files change. Native Rust hashing keeps it fast
• Local Metrics - Tracks task success and confidence calibration. All data stays on your machine
• Zero Config - Binary auto-installs on first session. --auto flag detects your stack automatically
• Any Stack - TypeScript, Python, Rust, Go, Ruby, Elixir. If there's a linter, there's a plugin

```bash

# Install plugins

han plugin install # Interactive mode

han plugin install --auto # Auto-detect your stack

han plugin install # Install specific plugin

# Manage plugins

han plugin search # Search marketplace

han plugin uninstall # Remove plugin

# Run hooks manually

han hook run # Run a specific hook

han hook explain # Show configured hooks

# MCP server

han mcp # Start MCP server for natural language hook execution

```

Full documentation at [han.guru/docs](https://han.guru/docs/)

See [CONTRIBUTING.md](CONTRIBUTING.md) for how to create new plugins.

MIT License - see [LICENSE](LICENSE)

---

Built by [The Bushido Collective](https://thebushido.co)