How to add external API calls in claude-hooks?

Edit the generated index.ts file to use async functions with npm packages like axios or fetch; the typed payloads ensure you access correct data for making API requests based on hook events.

Can I use claude-hooks with JavaScript instead of TypeScript?

No, claude-hooks is designed for TypeScript to leverage type safety; using JavaScript would bypass the typed payloads and auto-completion, negating its core benefits.

What's the difference between claude-hooks and manual Claude Code hook setup?

claude-hooks provides a structured, type-safe environment with generated utilities, while manual setup requires handling untyped JSON payloads and configuring everything from scratch, increasing error risk.

How to debug hooks in claude-hooks?

Use the session logging utilities in session.ts to track executions, and rely on TypeScript compile-time checks; console logs within hook handlers can also help monitor payloads and actions.

Is claude-hooks compatible with Claude Code's latest updates?

Check the package version and Claude Code's changelog; since hooks depend on Claude Code's API, breaking changes might require updates to type definitions or hook logic in your project.

What are the performance impacts of using claude-hooks?

Running hooks with Bun and TypeScript adds minor overhead, but for local development with Claude Code, the trade-off is acceptable given the benefits of type safety and maintainability.

claude-hooks — TypeScript Claude Hooks

What is claude-hooks?

claude-hooks is a TypeScript-powered development environment and CLI tool for customizing Claude Code's behavior through hooks. It generates a structured project with full type safety, enabling developers to write hook handlers with strongly-typed payloads and auto-completion, eliminating guesswork with untyped data.

Target Audience

Developers using Claude Code who want to extend or customize its behavior with type-safe, maintainable code, particularly those familiar with TypeScript and Node.js/Bun environments.

Value Proposition

Developers choose claude-hooks for its complete TypeScript support and strongly-typed payloads, which provide IntelliSense and reduce errors compared to working with untyped hook data. It offers a ready-to-customize setup with generated utilities, allowing focus on logic rather than configuration.

Overview

claude-hooks provides a powerful, TypeScript-based development environment for customizing Claude Code's behavior through hooks. It enables developers to write hook handlers with complete type safety, auto-completion, and access to strongly-typed payloads, eliminating the guesswork from working with untyped data.

Key Features

Full TypeScript Support — Write hooks with complete type safety and IntelliSense in familiar TypeScript syntax.
Typed Payloads — Access strongly-typed payload data for all hook types (PreToolUse, PostToolUse, Notification, Stop).
Ready-to-Customize Setup — Generates clean TypeScript files and configuration for immediate customization.
Generated Utilities — Includes type definitions, session tracking utilities, and a structured project layout.
Flexible Integration — Use any npm packages, async/await, or development patterns within your hooks.

Philosophy

The project emphasizes developer experience by providing a strongly-typed, intuitive interface for hook customization, allowing users to focus on logic rather than data structure validation.

claude-hooks

What is claude-hooks?

Overview

Key Features

Philosophy

Related Projects

Found a gem we're missing?

Use Cases

Best For

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions