Does it support Git integration?

Yes, when enableContextTracking is set to true, the SDK automatically collects Git metadata like branch names, commits, and repository status for use in your hooks.

What is the Claude Hooks SDK?

It is a type-safe TypeScript library designed to help developers build and manage 'hooks' that intercept and extend the behavior of the Claude Code CLI.

How do I troubleshoot my hooks?

The SDK includes a built-in Logger utility and records events to .claude/hooks/{clientId}/logs/events.jsonl when logEvents is enabled.

Can I use this to block specific terminal commands?

Yes, you can use the onPreToolUse hook to inspect bash commands and return a block() response to prevent Claude from executing dangerous actions.

Claude Hooks SDK

Name: Claude Hooks SDK
Author: hgeldenhuys

byhgeldenhuys

•

开发者工具

Builds type-safe TypeScript extensions to customize, monitor, and secure Claude Code's terminal behavior.

关于

The Claude Hooks SDK provides a robust, type-safe framework for developers to create custom lifecycle extensions for the Claude Code CLI. It simplifies the process of intercepting events like tool execution, prompt submissions, and session starts or stops through a centralized HookManager. With built-in support for context tracking, Git metadata, file change monitoring, and command-blocking guardrails, this SDK allows you to implement sophisticated automation and observability patterns while ensuring your hooks remain reliable with integrated failure queues and retry logic.

主要功能

Security guardrails for blocking dangerous or destructive CLI commands
Automated context tracking for Git metadata and session history
Configurable error handling with failure queues and retry mechanisms
Type-safe HookManager for intercepting CLI lifecycle events
Pre-built transforms for file change tracking and conversation logging
3 GitHub stars

使用场景

Syncing Claude's session activity and file edits to external logging or API services
Implementing a safety layer that audits and blocks high-risk terminal commands
Injecting custom project environment data or branch info into Claude prompts

关于

主要功能

Security guardrails for blocking dangerous or destructive CLI commands
Automated context tracking for Git metadata and session history
Configurable error handling with failure queues and retry mechanisms
Type-safe HookManager for intercepting CLI lifecycle events
Pre-built transforms for file change tracking and conversation logging
3 GitHub stars

使用场景

Syncing Claude's session activity and file edits to external logging or API services
Implementing a safety layer that audits and blocks high-risk terminal commands
Injecting custom project environment data or branch info into Claude prompts