vt-claude-hooks

Pre-built hooks for Claude Code — install with one command, works on Windows, macOS, and Linux.

Quick Start

npx vt-claude-hooks

This installs all available hooks into your project's .claude/ directory and configures .claude/settings.json automatically.

Usage

npx vt-claude-hooks                          # Install all hooks
npx vt-claude-hooks add <hook-name>          # Install a specific hook
npx vt-claude-hooks remove <hook-name>       # Remove a hook
npx vt-claude-hooks list                     # List available hooks

Available Hooks

| Hook | Event | Description | |------|-------|-------------| | ping-on-done | Stop | Plays a beep sound when Claude finishes a task | | skill-usage-logger | PostToolUse | Logs which skills Claude uses to .claude/skill-usage.log |

ping-on-done

Plays a short notification sound when Claude completes a response.

• Windows — PowerShell [console]::beep()
• macOS — afplay system sound
• Linux — paplay freedesktop sound

skill-usage-logger

Tracks which skills Claude invokes — clean, one-line-per-skill log:

[2026-06-09T14:08:26Z] SKILL: draw-erd
[2026-06-09T14:15:03Z] SKILL: gen-module
[2026-06-09T14:22:41Z] SKILL: review-code

No dependencies required — uses sed (available in any bash environment).

What It Does

Running npx vt-claude-hooks in your project directory:

1. Creates .claude/hooks/ and copies hook scripts
2. Creates or updates .claude/settings.json with hook configuration
3. Does not overwrite existing hooks config — safe to run multiple times

File Structure

your-project/
└── .claude/
    ├── settings.json          # Hook configuration (created/updated)
    ├── skill-usage.log        # Logger output (created at runtime)
    └── hooks/
        ├── ping-on-done.sh
        └── skill-usage-logger.sh

Requirements

• Node.js >= 14
• Bash (Git Bash on Windows, or native on macOS/Linux)

License

MIT