claude-hook-advisor

Claude Hook Advisor

A Rust CLI tool that integrates with Claude Code using hooks to provide intelligent command suggestions, semantic directory aliasing, command history tracking, and security pattern detection.

Features

- 🎯 Command Intelligence - Automatically map commands to your preferred alternatives (npm → bun, curl → wget)
- 📁 Directory Aliasing - Use natural language like "docs" or "project_docs" instead of typing full paths
- 📊 Command History - Track all commands Claude runs in a SQLite database with session tracking
- 🔒 Security Patterns - 27 built-in patterns detect dangerous code across 10+ languages
- ⚡ Fast & Lightweight - Rust-based with ~1-5ms hook response time

Quick Example

You: *"What files are in my docs?"*
Claude: *"I'll check your docs directory at /Users/you/Documents/Documentation"*

Claude tries: npm install
Tool suggests: bun install
Claude runs: bun install automatically

Claude tries to write: eval(userInput)
Tool warns: Security risk detected
Claude: Finds a safer alternative

Installation

Option 1: Plugin Marketplace (Recommended)

Includes automatic hook setup and slash commands (/history, /history-failures, /history-search).

Option 2: From crates.io

Option 3: From Source

Quick Start

1. Install via plugin marketplace (recommended) or cargo
2. Create .claude-hook-advisor.toml in your project root:

That's it! Start a Claude Code conversation and the hooks work automatically. Security patterns are enabled by default with no configuration needed.

📝 Optional: Enable Command History Tracking

Add to your .claude-hook-advisor.toml:

View history:

🔒 Optional: Disable Noisy Security Patterns

Security patterns are enabled by default. To disable specific patterns:

Configuration

Run claude-hook-advisor --install-hooks to…