Debug Hooks

Systematic workflow for debugging Claude Code hooks.

When to Use

• "Hook isn't firing"
• "Hook produces wrong output"
• "SessionEnd not working"
• "PostToolUse hook not triggering"
• "Why didn't my hook run?"

Workflow

1. Check Outputs First (Observe Before Editing)

# Check project cache
ls -la $CLAUDE_PROJECT_DIR/.claude/cache/