claude-code-hookslisted

# Claude Code Hook System (v2.1.87+) Empirically validated knowledge about Claude Code's hook system, distilled from PoC 001 and PoC 002. ## All 25 Hook Event Types ### Session Lifecycle | Event | Matcher | Blocking | Payload fields | |-------|---------|----------|----------------| | `SessionStart` | `source`: startup, resume, clear, compact | No | `source`, `model` | | `InstructionsLoaded` | `load_reason`: session_start, nested_traversal, path_glob_match, include, compact | No | `file_path`, `memory_type` (User/Project), `load_reason` | | `SessionEnd` | (none) | No | `reason`: clear, resume, logout, prompt_input_exit, bypass_permissions_disabled, other | ### User Input | Event | Matcher | Blocking | Payload fields | |-------|---------|----------|----------------| | `UserPromptSubmit` | (none) | Yes (exit 2 blocks) | `prompt`, `permission_mode` | ### Tool Execution | Event | Matcher | Blocking | Payload fields | |-------|---------|----------|----------------| | `PreToolUse` | tool name | Yes (`permissionDecision`) | `tool_name`, `tool_input`, `tool_use_id` | | `PostToolUse` | tool name | Partial | `tool_name`, `tool_input`, `tool_use_id`, `tool_response` | | `PostToolUseFailure` | tool name | No | `tool_name`, `tool_input`, `tool_use_id`, `error` | | `PermissionRequest` | tool name | Yes (`behavior`) | `tool_name`, `tool_input`, `permission_suggestions`, `permission_mode` | ### Turn Completion | Event | Matcher | Blocking | Payload fields | |-------|---------|----------