A 3rd-party SDK for claude-code Hooks

A TypeScript SDK to write claude-code hooks easily with type safety, dependency injection, and comprehensive testing support.

Quick Start

Installation

npm install -D @mizunashi_mana/claude-code-hook-sdk tsx

Basic Usage

Create a simple hook that logs all tool usage:

import { runHook } from '@mizunashi_mana/claude-code-hook-sdk';

void runHook({
  preToolUseHandler: async (input) => {
    console.error(`Tool: ${input.tool_name}`);
    return {};
  },
});

See examples.

Running Your Hook

Edit .claude/settings.json:

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "*",
        "hooks": [
          {
            "type": "command",
            "command": "npx tsx your-hook.ts"
          }
        ]
      },
    ]
  }
}

Reference

See also:

• Claude Code Official Reference: https://docs.anthropic.com/en/docs/claude-code/hooks

License Notice

This repository is offered under your choice of the following licenses:

• Apache License, Version 2.0
  You may use, modify, and distribute this repository under the terms of the Apache License 2.0.

• Mozilla Public License, Version 2.0
  You may use, modify, and distribute this repository under the terms of the Mozilla Public License 2.0.

Note: By contributing to or using this repository, you agree to comply with the full text of the license you select.

See LICENSE also.