Skip to content

README.md

Latest commit

 

History

History
92 lines (62 loc) · 3.25 KB

README.md

File metadata and controls

92 lines (62 loc) · 3.25 KB

Han

GitHub Release codecov

Ship-ready code from your AI coding agent. 139+ plugins for quality gates, tooling, memory, and specialized agents — so your AI writes code that's ready to merge.

Getting Started

Two commands. That's it.

# 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

# Homebrew (macOS/Linux)
brew install thebushidocollective/tap/han

How It Works

  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

Plugin Categories

139 plugins across six categories:

Category Description Examples
Core Essential infrastructure. Auto-installs han binary, provides metrics and MCP servers Always required
Languages Validation plugins for your language/runtime TypeScript, Rust, Python, Go, Ruby
Validation Linters, formatters, and quality tools Biome, ESLint, ShellCheck, Pytest
Disciplines Specialized AI agents for engineering domains Security, accessibility, API design, architecture
Services MCP servers for external platforms GitHub, GitLab, Linear
Tools MCP servers for development utilities Playwright, Blueprints, Context7

Browse all plugins at han.guru/plugins

Why It Works

  • 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

CLI Commands

# Install plugins
han plugin install              # Interactive mode
han plugin install --auto       # Auto-detect your stack
han plugin install <name>       # Install specific plugin

# Manage plugins
han plugin search <query>       # Search marketplace
han plugin uninstall <name>     # Remove plugin

# Run hooks manually
han hook run <plugin> <hook>    # Run a specific hook
han hook explain                # Show configured hooks

# MCP server
han mcp                         # Start MCP server for natural language hook execution

Documentation

Full documentation at han.guru/docs

Contributing

See CONTRIBUTING.md for how to create new plugins.

License

MIT License - see LICENSE

Built by The Bushido Collective