Claude Code Notification — AI skill for Claude Code

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

brew install wyattjoh/stable/claude-code-notification

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:

{
  "hooks": {
    "Notification": [
      {
        "matcher": "*",
        "hooks": [
          {
            "type": "command",
            "command": "claude-code-notification"
          }
        ]
      }
    ]
  }
}

**With Custom Sound:**

{
  "hooks": {
    "Notification": [
      {
        "matcher": "*",
        "hooks": [
          {
            "type": "command",
            "command": "claude-code-notification --sound Submarine"
          }
        ]
      }
    ]
  }
}

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](https://code.claude.com/docs/en/hooks) for the full list of matchers.