claude-code-hooks

claude-code-hooks

⚠️ This repository has moved to cc-safe-setup — 677 hooks, 9,200+ tests, one-command install. This repo (16 hooks) is the original version kept for backward compatibility.

Quick Start (New Repository)

npx cc-safe-setup            # Install 8 essential hooks in 10 seconds
npx cc-safe-setup --verify   # Test each hook works

677 Example Hooks | Interactive Hook Selector | Token Checkup (diagnose token waste)

Spending too much on Claude Code? The average developer spends $13/day on tokens. Our Token Book shows how to cut that in half with real data from 800+ hours of operation.

---

Original Repository (16 hooks)

Interactive Cookbook — search, filter, and copy 26 hook recipes in your browser.

16 hooks + 6 templates from 700+ hours of autonomous Claude Code operation.

┌─────────────────────────────────────────────────────────┐
│                   Claude Code Session                    │
│                                                         │
│  User Prompt ──→ PermissionRequest ──→ PreToolUse       │
│                  (auto-approve-      (destructive-guard  │
│                   readonly)           branch-guard       │
│                                       comment-strip      │
│                                       cd-git-allow        │
│                                       secret-guard)       │
│                         │                   │            │
│                         ▼                   ▼            │
│                    Tool Executes ──→ PostToolUse          │
│                                     (syntax-check        │
│                                      context-monitor     │
│                                      activity-logger     │
│                                      tmp-cleanup)        │
│                         │                                │
│                         ▼                                │
│                   Session End ──→ Stop                    │
│                                  (proof-log-session)     │
│                                                         │
│  Notification ──→ no-ask-human                           │
│  PreCompact   ──→ proof-log-session                      │
└─────────────────────────────────────────────────────────┘

Production infrastructure for running Claude Code autonomously. Every hook exists because something went wrong without it. Every template encodes a workflow pattern that survived real-world autonomous operation.

Honest disclaimer: This is what works for us. Your workflow may differ. These hooks and templates address the failure modes we actually encountered.

Covers 18 of 20 checks in cc-health-check.

Get Started in 10 Seconds

npx cc-safe-setup            # Install 8 essential hooks
npx cc-safe-setup --verify   # Test each hook works
npx cc-safe-setup --doctor   # Diagnose any issues
npx cc-safe-setup --create "block npm publish without tests"  # Generate custom hooks

Want 677 hooks? Use cc-safe-setup — the successor to this repo with 40x more hooks, comprehensive tests, and one-command install.

New to hooks? Read the Troubleshooting Guide or print the Cheat Sheet.

Losing tokens too fast? Token Book — real optimization data from 800+ hours (¥2,500, Chapter 1 free).

---

What's Included

Hooks (16)