Intelligent hooks system that makes Claude Code smarter, safer, and more reliable through learning and automation

Find a file

Ryan Malloy 392833187e Claude hooks auto-backup: manual (backup_20250720_091250)		2025-07-20 03:12:51 -06:00
bin	Claude hooks auto-backup: manual (backup_20250720_091250)	2025-07-20 03:12:51 -06:00
config	Claude hooks auto-backup: manual (backup_20250720_091250)	2025-07-20 03:12:51 -06:00
docs	Claude hooks auto-backup: manual (backup_20250720_091250)	2025-07-20 03:12:51 -06:00
hooks	Claude hooks auto-backup: manual (backup_20250720_091250)	2025-07-20 03:12:51 -06:00
lib	Claude hooks auto-backup: manual (backup_20250720_091250)	2025-07-20 03:12:51 -06:00
node_modules	Claude hooks auto-backup: manual (backup_20250720_091250)	2025-07-20 03:12:51 -06:00
scripts	Claude hooks auto-backup: manual (backup_20250720_091250)	2025-07-20 03:12:51 -06:00
test-clone@1e169a5d45	Add NPM distribution support with hybrid installation approach	2025-07-19 21:03:13 -06:00
.gitignore	Initial commit: Claude Code Hooks with Diátaxis documentation	2025-07-19 18:25:34 -06:00
DEMO.md	Initial commit: Claude Code Hooks with Diátaxis documentation	2025-07-19 18:25:34 -06:00
LICENSE	Initial commit: Claude Code Hooks with Diátaxis documentation	2025-07-19 18:25:34 -06:00
package-lock.json	Claude hooks auto-backup: manual (backup_20250720_091250)	2025-07-20 03:12:51 -06:00
package.json	Claude hooks auto-backup: manual (backup_20250720_091250)	2025-07-20 03:12:51 -06:00
README.md	Claude hooks auto-backup: manual (backup_20250720_091250)	2025-07-20 03:12:51 -06:00
setup.py	Initial commit: Claude Code Hooks with Diátaxis documentation	2025-07-19 18:25:34 -06:00

README.md

Claude Hooks

Intelligent hooks system for Claude Code that provides command validation, session continuity, and learning capabilities using Claude Code's native hooks architecture.

Quick Start

# Install globally via npm
npm install -g claude-hooks

# Initialize hooks
claude-hooks init

# Test installation
claude-hooks test

# Restart Claude Code to activate

Features

🧠 Shadow Learning - Learns from command failures and suggests working alternatives
📊 Context Monitoring - Automatically backs up work before context limits
⚡ Smart Validation - Blocks dangerous commands with intelligent suggestions
🔄 Session Continuity - Maintains history and state across Claude restarts

Usage

After installation, Claude Hooks runs automatically:

Command Learning: Try pip install requests → suggests pip3 install requests
Auto Backup: Triggers before context limits or manually with claude-hooks backup
Status Check: Run claude-hooks status to verify installation
Manual Test: Use claude-hooks test to verify all components

Commands

claude-hooks init          # Initialize after npm install
claude-hooks status        # Check installation status  
claude-hooks test          # Run test suite
claude-hooks backup        # Create manual backup
claude-hooks uninstall     # Remove hooks configuration
claude-hooks --help        # Show all commands

How It Works

Claude Hooks uses Claude Code's native hook system with four key integration points:

UserPromptSubmit: Monitors context usage and triggers backups
PreToolUse[Bash]: Validates commands and suggests alternatives
PostToolUse[*]: Logs activity and learns from patterns
Stop: Finalizes sessions and creates continuation docs

Installation Methods

NPM (Recommended)

npm install -g claude-hooks
claude-hooks init

Git (Development)

git clone https://git.supported.systems/rsp2k/claude-hooks.git
cd claude-hooks && ./scripts/install.sh

Documentation

Requirements

Node.js 16+ (only runtime required)
Claude Code (hooks integrate with Claude's native system)

License

MIT License - see LICENSE for details.

Claude Code Hooks makes your AI assistant smarter by giving it memory, environmental awareness, and the ability to learn from experience.