Which Claude Code events can I hook into?

You can hook into SessionStart, PreToolUse, PostToolUse, PostToolUseFailure, and Notification events to customize Claude's behavior.

Do I need a specific runtime to use this skill?

Yes, this skill is designed to work with Bun, which provides high-performance execution for TypeScript-based hooks in the Claude environment.

Can I use this to block Claude from writing to certain files?

Yes, by using the PreToolUse event, you can inspect the file_path input and return a blocking error if the operation targets a protected directory.

What is cc-hooks-ts used for?

It is a library and guide for creating type-safe hooks in Claude Code, allowing developers to automate tasks, validate inputs, or restrict actions based on specific tool events.

Is it possible to add types for custom tools?

Absolutely. The library allows you to extend the ToolSchema interface to provide full type safety for inputs and outputs of custom tools, including those defined via MCP.

TypeScript Claude Code Hooks (cc-hooks-ts)

Name: TypeScript Claude Code Hooks (cc-hooks-ts)
Author: masseater

bymasseater

•

Developer Tools

Simplifies the creation of type-safe Claude Code hooks using TypeScript and Bun for automated event handling and tool validation.

cc-hooks-ts provides a robust framework and guide for building sophisticated hooks within Claude Code, ensuring type safety and structured responses through TypeScript. It allows developers to intercept critical events such as session starts, tool executions, and failures to implement custom logic like environment health checks, access control for sensitive files, and automated context injection. By leveraging the Bun runtime, it streamlines the development of plugin-level automations that enhance the reliability, security, and productivity of AI-driven coding workflows.

Key Features

011 GitHub stars

02Standardized context methods for success, blocking errors, and JSON responses

03Type-safe API for defining Claude Code hooks with TypeScript

04Fine-grained tool-specific filtering and conditional execution logic

05Support for all major event triggers including PreToolUse, PostToolUse, and SessionStart

06Easy integration with plugin.json using the Bun runtime and shebang support

Use Cases

01Preventing Claude from accessing or modifying sensitive files like .env or system configurations

02Verifying environment prerequisites and dependencies at the start of every AI session

03Automatically injecting project-specific knowledge or documentation after file edits

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add masseater/claude-code-plugin cc-hooks-ts

For use in Claude.ai and ChatGPT

Download Skill