claude-code-hooks

🪝 Ready-to-use hooks for Claude Code — safety, automation, notifications, and more.

🎬 Quick Demo

A growing collection of tested, documented hooks you can copy, paste, and customize.

---

📑 Table of Contents

• Hooks
• Quick Start
• Safety Levels
• Testing
• Contributing

---

🪝 Hooks

Pre-Tool-Use

Runs before Claude executes a tool. Can block or modify the operation.

Post-Tool-Use

Runs after Claude executes a tool. Can react to results.

Notification

Fires when Claude needs user attention.

Utils

Tools to help you build and debug hooks.

💡 Building a new hook? Use event-logger.py to discover what data Claude Code provides for each event before writing your own hooks.

---

🚀 Quick Start

1. Copy the hook script:

mkdir -p ~/.claude/hooks
cp hook-scripts/pre-tool-use/block-dangerous-commands.js ~/.claude/hooks/

2. Add to .claude/settings.json:

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "node ~/.claude/hooks/block-dangerous-commands.js"
          }
        ]
      }
    ]
  }
}

3. Restart Claude Code — the hook is now active.

💡 Tip: Use multiple hooks together. Combine block-dangerous-commands + protect-secrets for comprehensive safety.

---

🛡️ Safety Levels

Security hooks support configurable safety levels:

To change: Edit the SAFETY_LEVEL constant at the top of each hook.

const SAFETY_LEVEL = 'strict'; // or 'critical', 'high'

---

🧪 Testing

All hooks include comprehensive tests:

# Run all tests
npm test

# Run specific hook tests
node --test hook-scripts/tests/pre-tool-use/block-dangerous-commands.test.js

Test coverage:

• ✅ Unit tests for core functions
• ✅ Integration tests for stdin/stdout flow
• ✅ Config validation tests

---

📖 Configuration Reference

See the official Claude Code hooks documentation for:

• All hook events and their lifecycles
• Input/output JSON formats
• Matcher patterns
• Environment variables

---

🤝 Contributing

Contributions welcome! See CONTRIBUTING.md for guidelines.

Ideas for new hooks:

---

📄 License

MIT © karanb192