claude-hooks Updates & Release Notes

Release Notes - v3.1.1

🚀 Context Forge Integration - Enable Multi-Hour AI Development Workflows!

We're thrilled to announce the integration with Context Forge, solving one of the biggest challenges in AI-assisted development: context loss during extended coding sessions.

The Problem

When working with Claude Code for extended periods, the context window fills up (typically every 2 hours) and performs "compaction". During this process, Claude forgets:

Your project-specific rules and conventions
Current implementation stage and progress
PRP guidelines and specifications
Bug tracking history

The Solution

Our new Context Forge hooks provide automatic context recovery:

PreCompact Hook - Detects Context Forge projects before compaction
Stop Hook - Forces Claude to re-read critical files after compaction
Smart Detection - Only activates for Context Forge projects
Zero Configuration - Works automatically once installed

Benefits

✅ 8+ Hour Development Sessions - Work all day without context loss
✅ Automatic Recovery - No manual reminders needed
✅ Maintained Quality - Consistent standards throughout
✅ PRP Compliance - Continuous adherence to specifications

Quick Setup

Install Context Forge:

npm install -g context-forge

Create a Context Forge project:

context-forge init

Install the Context Forge hooks:

cd ~/.claude/hooks
git clone https://github.com/webdevtodayjason/claude-hooks.git
cd claude-hooks/hooks/context-forge
./install-context-forge-hooks.sh

What's Included

precompact-context-refresh.py - PreCompact hook
stop-context-refresh.py - Stop hook
context-forge-utils.py - Utility functions
install-context-forge-hooks.sh - Easy installation
Comprehensive documentation and examples

Documentation

Context Forge Integration Guide
Integration Technical Details
Testing Guide

Other Changes

Updated README with prominent Context Forge section
Added "The Perfect AI Development Workflow" guide
Increased total hook count to 20
Enhanced documentation structure

This release transforms AI-assisted development from short sessions into productive all-day workflows. No more context loss, no more repetitive reminders - just continuous, high-quality development with Claude Code.

Full Changelog: https://github.com/webdevtodayjason/claude-hooks/blob/main/CHANGELOG.md

🚨 Breaking Change - Project Renamed

This major release renames the project from claude-code-hooks to claude-hooks-manager.

📦 New Package Name

# Old package (deprecated)
npm uninstall -g claude-code-hooks
# New package
npm install -g claude-hooks-manager

What's Changed

Project Name: claude-code-hooks → claude-hooks-manager

NPM Package: claude-code-hooks → claude-hooks-manager

CLI Command: claude-hooks (unchanged for compatibility)

All "Claude Code" references updated to "Claude"

Why the Rename?

Better reflects the tool's purpose as a management system for Claude hooks

Avoids potential trademark concerns with Anthropic's "Claude Code" branding

Clearer positioning as a community tool

Features Included

18 total hooks including the new timestamp-validator

Complete hook management suite (enable/disable/create/edit/remove)

Comprehensive documentation for custom hook development

Interactive CLI with beautiful UI

Migration Guide

Uninstall the old package: npm uninstall -g claude-code-hooks

Install the new package: npm install -g claude-hooks-manager

All your hooks and settings remain unchanged

CLI commands stay the same (claude-hooks)

Full Changelog: v2.2.2...v3.0.0

Documentation & Time Accuracy

This release adds comprehensive documentation for custom hook development and a new timestamp validation hook.

New Hook: timestamp-validator

• Validates dates in documentation and changelogs
• Prevents incorrect dates (e.g., January dates in July)
• Warns about future dates or unreasonable timestamps
• Provides current date/time in multiple formats
• Catches common temporal mistakes in commits

Documentation

• Comprehensive Custom Hook Development Guide
• Complete tutorial with examples
• Hook architecture explanation
• Input/output specifications
• Best practices and troubleshooting
• Multiple real-world examples
• Enhanced README with prominent documentation links
• Better documentation organization

Why timestamp-validator?

This hook was created after experiencing date confusion in our own development. It ensures your documentation always has accurate temporal information by validating against system time.

Installation

npm install -g claude-code-hooks@latest

Quick Start

# Install/update hooks
claude-hooks install
# Create your own custom hook
claude-hooks create my-custom-hook

Full Changelog: v2.2.1...v2.2.2

UI Enhancements

This patch release adds visual status indicators to improve hook management visibility.

What's New

• Visual Status Indicators in list command
• 🟢 Green dot for enabled hooks
• 🔴 Red dot for disabled hooks
• ⚪ Gray circle for not installed hooks
• Enhanced Status Command with detailed hook counts by state
• Status Indicators in Menus for better visual feedback

Example Output

Available Claude Code Hooks:

• pre-commit-validator.py Enforces coding standards before commits
• validate-git-commit.py Validates commit message format
• database-extension-check.py Validates database migration files
• Enabled ● Disabled ○ Not Installed

Installation

npm install -g claude-code-hooks@latest

Full Changelog: v2.2.0...v2.2.1

Complete Hook Management Suite

This release adds comprehensive hook management capabilities to the Claude Code Hooks CLI.

New Hook Management Commands

Enable/Disable - claude-hooks enable/disable <hook> toggles hooks on/off

Create - claude-hooks create <name> generates new custom hooks with templates

Edit - claude-hooks edit <hook> opens hooks in your preferred editor

Remove - claude-hooks remove <hook> permanently deletes hooks

Config - claude-hooks config edits Claude Code settings.json

Enhanced Interactive Menu

Added "Hook Management" section with all new commands

Added "Configuration" section for settings and project setup

Better organization with separators

Beautiful UI with colors and loading spinners

Repository Improvements

Fixed node_modules being tracked in git

Added proper .gitignore configuration

Cleaned up repository structure

Installation

npm install -g claude-code-hooks

Quick Start

Run claude-hooks to launch the interactive menu and explore all the new features!

Full Changelog: v2.1.0...v2.2.0

Claude Code Hooks v2.0.0

This is the first official release of Claude Code Hooks - a comprehensive collection of 16 production-ready hooks designed to enforce coding standards, maintain consistency, and automate workflow tasks.

Highlights

• 16 Production-Ready Hooks - Complete set for quality, security, and workflow automation
• 6 New Advanced Hooks - Added in this release for enhanced capabilities
• Comprehensive Test Suite - All hooks are tested and verified
• Beautiful Documentation - Enhanced README with badges and detailed explanations
• Community Ready - Added LICENSE, CODE_OF_CONDUCT, and CONTRIBUTING guides

New Hooks in v2.0.0

Security & Quality

• api-docs-enforcer.py - Ensures API documentation with Swagger/OpenAPI
• no-mock-code.py - Prevents placeholder/mock code in production
• secret-scanner.py - Detects and blocks secrets from being committed
• env-sync-validator.py - Keeps .env and .env.example synchronized
• gitignore-enforcer.py - Ensures proper .gitignore configuration
• readme-update-validator.py - Reminds to update docs when features change

Installation

# Clone the repository
git clone https://github.com/webdevtodayjason/claude-hooks.git
cd claude-hooks
# Run the install script
chmod +x install.sh
./install.sh

Testing

# Run tests
npm test
# Or run detailed tests
python3 test_hooks.py

Documentation

Comprehensive README with accordion sections for each hook

User-friendly explanations in plain English

Practical examples for every hook

Contributing guidelines

Thanks

Thank you to everyone who will use and contribute to this project! Together we can make Claude Code development more efficient and enjoyable.

Full Changelog: https://github.com/webdevtodayjason/claude-hooks/blob/main/CHANGELOG.md