Ryan Malloy
9445e09c48
Major changes: - Add package.json with NPM packaging configuration - Create Node.js CLI interface (bin/claude-hooks.js) with full command set - Convert bash scripts to Python for better npm integration - Add npm postinstall/preuninstall hooks for automatic setup - Update bootstrap prompt to recommend NPM method with git fallback - Enhance README with NPM-first documentation - Maintain backward compatibility with existing git installation Features: - npm install -g claude-hooks for easy distribution - claude-hooks init/status/test/backup/uninstall commands - Automatic Python dependency installation - Conflict detection and prevention - Hybrid approach supporting both npm and git workflows This resolves installation complexity while maintaining developer flexibility. 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
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→ suggestspip3 install requests - Auto Backup: Triggers before context limits or manually with
claude-hooks backup - Status Check: Run
claude-hooks statusto verify installation - Manual Test: Use
claude-hooks testto 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+ (for npm installation)
- Python 3.8+ (for hook scripts)
- 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.