buhi

Configure Stop and PreToolUse hooks to play audible notifications in Claude Code.

3|1|Updated Aug 1, 2025
One-click install
npx skills add https://github.com/guchey/buhi --skill buhi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: buhi
Source: https://github.com/guchey/buhi/tree/main/skills/buhi
Command: npx skills add https://github.com/guchey/buhi --skill buhi

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Audible notifications save time by alerting you to task completions and required confirmations without watching the terminal.

Core Features & Use Cases

  • Manual playback: Test the notification sound with /buhi.
  • Automatic notifications: Play sounds on task completion (Stop hook) and user confirmations (PreToolUse with AskUserQuestion).
  • Global vs Local: Automatically detects installation scope and updates the correct settings.json.

Quick Start

Run /buhi to test playback and enable task completion and user-confirmation alerts.

Frequently Asked Questions about buhi

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up audible notifications for Claude Code task completions?

You can configure audible notifications for Claude Code by running the /buhi command, which automatically sets up Stop and PreToolUse hooks in your settings.json to play a sound when tasks finish or require user confirmation.

Can I play a sound when Claude Code requests user confirmation?

Yes, you can play a sound for user confirmations by configuring a PreToolUse hook with AskUserQuestion in your settings.json, which alerts you audibly whenever Claude Code needs your input.

Does the audible alert work with both global and per-project Claude Code installations?

Yes, the audible alert integration automatically detects your installation scope and updates the correct settings.json file, supporting both global and per-project Claude Code environments.

How do hooks in settings.json trigger audio playback for Claude Code workflows?

Hooks in settings.json trigger audio playback by executing commands that call an OS-specific audio player to play the buhi.m4a file whenever a Stop or PreToolUse event occurs in Claude Code.

Will setting up Claude Code sound alerts overwrite my existing hooks configuration?

No, setting up Claude Code sound alerts will preserve your existing hooks configuration, seamlessly integrating the new audible notification hooks alongside any previously configured settings.

What is the best way to get alerted when a long-running Claude Code task finishes?

The best way to get alerted when a long-running Claude Code task finishes is to enable Stop hooks that play an audible sound upon completion, allowing you to step away from the terminal without constantly monitoring it.