claude-hooks

{
  "aliases": [],
  "alternatives": [],
  "build_dependencies": [],
  "categories": [],
  "caveats": null,
  "conflicts_with": [],
  "dependencies": [
    "node"
  ],
  "deprecated": 0,
  "deprecation_reason": null,
  "desc": "Hook system for Claude Code",
  "disable_reason": null,
  "disabled": 0,
  "enrichment_fetched_at": "2026-06-20T23:36:25+00:00",
  "first_seen": "2026-06-20T23:34:18+00:00",
  "full_name": "claude-hooks",
  "github_default_branch": "main",
  "github_last_commit_at": "2025-08-08T03:19:00Z",
  "github_readme_excerpt": "# claude-hooks\n\n[![Version](https://img.shields.io/npm/v/claude-hooks.svg)](https://npmjs.org/package/claude-hooks)\n[![License](https://img.shields.io/npm/l/claude-hooks.svg)](https://github.com/johnlindquist/claude-hooks/blob/main/LICENSE)\n[![CI](https://github.com/johnlindquist/claude-hooks/actions/workflows/test.yml/badge.svg)](https://github.com/johnlindquist/claude-hooks/actions/workflows/test.yml)\n\n\u003e TypeScript-powered hook system for Claude Code - write hooks with full type safety and auto-completion\n\n## Overview\n\n`claude-hooks` gives you a powerful, TypeScript-based way to customize Claude Code\u0027s 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!\n\n## Requirements\n\n- [Bun](https://bun.sh) runtime (required for running hooks)\n- Node.js 18+ (for running the CLI)\n\n## Quick Start\n\n```bash\nnpx claude-hooks\n```\n\nThis will:\n- Create `.claude/settings.json` with hook configuration\n- Generate `.claude/hooks/index.ts` with TypeScript handlers\n- Set up typed payload interfaces for all hook types\n- Create utilities for easy hook development\n\n## Installation\n\n### Using npx (Recommended)\n\n```bash\nnpx claude-hooks\n```\n\n### Global Installation\n\n```bash\nnpm install -g claude-hooks\nclaude-hooks\n```\n\n## What It Does\n\nThe CLI sets up a complete TypeScript development environment for Claude hooks:\n\n1. **Full TypeScript Support** - Write hooks with complete type safety and IntelliSense\n2. **Typed Payloads** - Access strongly-typed payload data for all hook types (PreToolUse, PostToolUse, Notification, Stop)\n3. **Ready-to-Customize** - Simple, clean TypeScript files ready for your custom logic\n4. **Generated Files**:\n   - `.claude/settings.json` - Hook configuration\n   - `.claude/hooks/index.ts` - Your main hook handlers (edit this!)\n   - `.claude/hooks/lib.ts` - Type definitions and utilities\n   - `.claude/hooks/session.ts` - Optio",
  "github_repo": "johnlindquist/claude-hooks",
  "github_stars": 380,
  "github_topics": [],
  "homepage": "https://github.com/johnlindquist/claude-hooks",
  "homepage_og_description": null,
  "homepage_og_image": null,
  "homepage_title": null,
  "installs_30d": 25,
  "installs_365d": 323,
  "installs_90d": 89,
  "keg_only": 0,
  "keg_only_reason": null,
  "last_seen": "2026-06-20T23:34:18+00:00",
  "license": "MIT",
  "llm_generated_at": null,
  "llm_model": null,
  "name": "claude-hooks",
  "oldnames": [],
  "one_liner": null,
  "optional_dependencies": [],
  "rank_30d": 6284,
  "rank_365d": 6136,
  "rank_90d": 5863,
  "raw_hash": "24cb074842e73387",
  "recommended_dependencies": [],
  "revision": 0,
  "ruby_source_path": "Formula/c/claude-hooks.rb",
  "tap": "homebrew/core",
  "test_dependencies": [],
  "uses_from_macos": [],
  "version_head": null,
  "version_stable": "2.4.0",
  "versioned_formulae": [],
  "why_use_this": null
}