claude-code-notification

Claude Code Notifier

A high-performance Rust CLI tool for displaying cross-platform desktop notifications as a Claude Code hook, with advanced sound support and parallel execution.

Installation

Features

- Cross-Platform Notifications - Native desktop notifications on Windows, macOS, and Linux
- Advanced Sound Support - System sounds and custom audio files with intelligent path resolution
- Parallel Execution - Notification display and sound playback execute simultaneously
- Claude Code Integration - Seamless hook integration with JSON-based interface
- Error Resilience - Graceful handling of sound failures without blocking notifications
- High Performance - Compiled Rust binary with optimized release builds

Requirements

- Rust (for building from source)
- macOS with afplay (for sound support)
- Claude Code (for hook integration)

Usage

The tool integrates with Claude Code as a notification hook, receiving JSON input via stdin and displaying native notifications with optional sound playback.

Basic Integration:

Configure in your Claude Code settings:

With Custom Sound:

The matcher field can be left empty to fire on all notification events, or set to a specific event type (e.g. permission_prompt, idle_prompt, auth_success). See the Claude Code hooks documentation for the full list of matchers.

Configuration

Sound Options

The --sound parameter supports two modes:

System Sounds (no / in name):
- Resolves to /System/Library/Sounds/{name}.aiff
- Available: Glass (default), Submarine, Frog, Purr, Basso, Blow, Bottle, Funk, Hero, Morse, Ping, Pop, Sosumi, Tink

Custom Paths (contains /):
- Used directly as file path to afplay
- Supports: .wav, .aiff, .mp3, .m4a, and other formats supported by afplay
- Examples:
  - --sound /path/to/custom/sound.wav
  - --sound…