Baike.dev
All toolsOnline toolsAI codingTrendingOpen sourceNewsSubmit
Log in
< Back to tools
C

claude-hooks

> 编程语言
Open source

claude-hooks TypeScript-powered hook system for Claude Code - write hooks with full type safety and auto-completion Overview claude-hooks g…

391 stars0 likes0 views
WebsiteGitHub

About

claude-hooks TypeScript-powered hook system for Claude Code - write hooks with full type safety and auto-completion Overview claude-hooks g…

claude-hooks

TypeScript-powered hook system for Claude Code - write hooks with full type safety and auto-completion

Overview

claude-hooks gives you a powerful, TypeScript-based way to customize Claude Code's behavior. Write hooks with full type safety, auto-completion, and access to strongly-typed payloads - all in familiar TypeScript syntax. No more guessing payload structures or dealing with untyped data!

Requirements

  • Bun runtime (required for running hooks)
  • Node.js 18+ (for running the CLI)

Quick Start

bash
npx claude-hooks

This will:

  • Create .claude/settings.json with hook configuration
  • Generate .claude/hooks/index.ts with TypeScript handlers
  • Set up typed payload interfaces for all hook types
  • Create utilities for easy hook development

Installation

Using npx (Recommended)

bash
npx claude-hooks

Global Installation

bash
npm install -g claude-hooks
claude-hooks

What It Does

The CLI sets up a complete TypeScript development environment for Claude hooks:

  1. Full TypeScript Support - Write hooks with complete type safety and IntelliSense
  2. Typed Payloads - Access strongly-typed payload data for all hook types (PreToolUse, PostToolUse, Notification, Stop)
  3. Ready-to-Customize - Simple, clean TypeScript files ready for your custom logic
  4. Generated Files:
    • .claude/settings.json - Hook configuration
    • .claude/hooks/index.ts - Your main hook handlers (edit this!)
    • .claude/hooks/lib.ts - Type definitions and utilities
    • .claude/hooks/session.ts - Optional session tracking utilities

Generated Structure

.claude/
├── settings.json
└── hooks/
    ├── index.ts
    ├── lib.ts
    └── session.ts

Session logs are saved to: /claude-hooks-sessions/

Customizing Hooks

The real power comes from editing .claude/hooks/index.ts. You get full TypeScript support with typed payloads:

…

The beauty is that you're writing regular TypeScript - use any npm packages, async/await, or patterns you're familiar with!

Command Options

bash
claude-hooks init [OPTIONS]

OPTIONS:
  -f, --force    Overwrite existing hooks
  -h, --help     Show help

Requirements

  • Node.js >= 18.0.0
  • Bun - Required to run the hooks
    bash
    curl -fsSL https://bun.sh/install | bash

License

MIT

Issues· 0 open

View all issuesOpen on GitHub

No open issues yet, or sync has not completed.

> Tags

TypeScript

No comments yet. Be the first to share.

> Details

PublishedAug 1, 2026
UpdatedSep 17, 2026
Category编程语言
PricingOpen source

> Related tools

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言