htlin222/hook

Hook Management System

Manage Claude Code hooks for the current session.

When to use

• When you need to check the status of Claude Code hooks
• When you want to temporarily disable a noisy or problematic hook
• When debugging hook behavior or performance issues
• When monitoring hook execution metrics

Usage

/hook status                  # Show all hooks and their status
/hook list                    # List available hooks with descriptions
/hook disable [hook-name]     # Temporarily disable a hook
/hook enable [hook-name]      # Re-enable a disabled hook
/hook profile                 # Show hook performance metrics
/hook logs [hook-name]        # View recent logs for a hook

Instructions

When this command is invoked:

/hook status

1. Read ~/.claude/settings.json
2. Parse the hooks configuration
3. Check ~/.claude/hooks/.disabled for disabled hooks
4. Display in a formatted table:
   • Hook type (SessionStart, PreToolUse, PostToolUse, and others)
   • Matcher pattern
   • Command/Prompt
   • Status (enabled/disabled)

/hook list

1. Scan ~/.claude/hooks/ directory
2. List each hook file with:
   • Filename
   • Description (from docstring)
   • Trigger type
   • Last modified

/hook disable [hook-name]

1. Create/update ~/.claude/hooks/.disabled file
2. Add the hook name to the disabled list
3. Hooks check this file before running
4. Note: Changes persist until re-enabled

/hook enable [hook-name]

1. Read ~/.claude/hooks/.disabled file
2. Remove the hook name from the disabled list
3. Confirm the hook is re-enabled

/hook profile

1. Read ~/.claude/logs/hook_metrics.jsonl
2. Calculate average execution time per hook
3. Show:
   • Hook name
   • Avg execution time (ms)
   • Total calls
   • Success rate
   • Token impact estimate

/hook logs [hook-name]

1. Find log files in ~/.claude/logs/
2. Filter by hook name
3. Show last 20 entries
4. Include timestamp, result, and any errors

Examples

# Check current hook status
/hook status

# Disable noisy notifications temporarily
/hook disable notification

# Re-enable when ready
/hook enable notification

# Check performance impact
/hook profile

# Debug a specific hook
/hook logs post_tool_use

Notes

• Disabled state uses ~/.claude/hooks/.disabled file
• Performance data from ~/.claude/logs/hook_metrics.jsonl
• Hooks check disabled state before executing
• Session-based disabling (resets on restart)