cc-hooks-ts

Type-safe Claude Code hooks use the cc-hooks-ts library with TypeScript to define hooks via defineHook, providing compile-time safety. Install with bun add cc-hooks-ts, create a hook.ts file using defineHook, and run it with bun. This eliminates boilerplate and catches errors at compile time rather than runtime.

PreToolUse and PostToolUse are event-driven hooks that trigger before and after tool execution. Use them to automate policy checks, logging, validation, or transformations on tool inputs and outputs without modifying tool code itself.

Wire hooks into Claude Code by defining hook entries in plugin.json with trigger type, handler path, and schema. The cc-hooks-ts guide includes plugin.json configuration examples showing how to register PreToolUse, PostToolUse, and SessionStart hooks with proper context methods.

Yes. SessionStart, PreToolUse, and PostToolUse hooks let you enforce policies deterministically across tool integrations. Define rules once in a single hook and apply them to all tools without duplicating logic in each integration.

Hooks expose context methods including success for normal completion, blockingError to halt execution with an error, and json for structured logging. These methods control hook behavior and enable deterministic automation patterns.

Basic TypeScript familiarity helps, but cc-hooks-ts provides practical examples and full code snippets covering installation, basic hooks, and real-world scenarios. The defineHook API and trigger schemas are straightforward to follow.