20-hooks-system

Shared from "Claude-Code" on Inkdown

Hooks System: Pre/Post Sampling Architecture

Overview

The Hooks System is Claude Code's extension mechanism for modifying behavior without changing core code. It provides interception points before and after key operations, enabling git tracking, metrics, safety checks, and custom extensions.

Plain text

File	Purpose
`types/hooks.ts`	Hook type definitions
`utils/hooks/hookHelpers.ts`	Hook registration and execution
`utils/hooks/postSamplingHooks.ts`	Post-sampling hook implementation
`utils/hooks/preSamplingHooks.ts`	Pre-sampling hook implementation
`utils/hooks/sessionHooks.ts`	Session lifecycle hooks
`utils/hooks/hookEvents.ts`	Hook event bus
`tools/shared/gitOperationTracking.ts`	Git tracking hooks

20-hooks-system

Hooks System: Pre/Post Sampling Architecture

Overview

20-hooks-system

Hooks System: Pre/Post Sampling Architecture

Overview

Core Files

Hook Interface

Hook Registration

Pre-Sampling Hooks

Git Tracking Hook (Pre-Edit)

Permission Check Hook (Pre-Tool)

Safety Hook (Pre-Bash)

Post-Sampling Hooks

Metrics Hook

File History Hook

Auto-Compact Hook

Session Lifecycle Hooks

Hook Integration in Tool Execution

Key Design Principles

Debugging Hooks