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)

/plugin marketplace add sirmews/claude-hook-advisor
/plugin install claude-hook-advisor@sirmews

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

Option 2: From crates.io

cargo install claude-hook-advisor
claude-hook-advisor --install-hooks

Option 3: From Source

git clone https://github.com/sirmews/claude-hook-advisor.git
cd claude-hook-advisor
make install

Quick Start

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

# Command mappings - map any command to your preferred tool
[commands]
npm = "bun"
yarn = "bun"
curl = "wget --verbose"

# Directory aliases - use natural language in conversations
[semantic_directories]
"project docs" = "~/Documents/my-project/docs"
"test data" = "~/Documents/test-data"

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

[command_history]
enabled = true
log_file = "~/.claude-hook-advisor/bash-history.db"

claude-hook-advisor --history               # Recent commands
claude-hook-advisor --history --failures    # Only failed commands
claude-hook-advisor --history --pattern git # Filter by pattern

[security_pattern_overrides]
swift_force_unwrap = false      # Common in Swift code
eval_injection = false          # If working on a REPL
rust_unsafe_block = false       # For systems programming

Configuration

Run claude-hook-advisor --install-hooks to automatically configure hooks, or manually add to .claude/settings.json:

{
  "hooks": {
    "PreToolUse": { "Bash": "claude-hook-advisor --hook" },
    "UserPromptSubmit": { ".*": "claude-hook-advisor --hook" },
    "PostToolUse": { "Bash": "claude-hook-advisor --hook" }
  }
}

📚 Documentation