claude-code-notifications

🔔 Claude Code Notifications

  Never miss Claude's response again

  *Elegant notification solutions for Claude Code CLI - from simple terminal bells to rich desktop alerts*

  Quick Start • Installation • Configuration • Examples

✨ The Problem We Solve

Ever found yourself:
- 🤔 Constantly switching tabs to check if Claude has responded?
- 😔 Missing Claude's questions while working in another window?
- ⏰ Wasting time waiting when Claude has already finished?

We've got you covered! Choose from three notification styles that fit your workflow perfectly.

🎯 Choose Your Style

  Minimal • Recommended • Custom

🚀 Quick Start

Most users should use the Recommended tier:

That's it! You now have smart audio notifications configured. 🎉

📋 Installation

Prerequisites

- Claude Code CLI installed (claude command available)
- macOS / Linux / Windows operating system
- Audio output for sound notifications

Installation Options

🎯 Option 1: Automatic Installation (Recommended)

Or clone and run locally:

The installer will:
- ✅ Detect your operating system
- ✅ Automatically download configurations from GitHub (no cloning needed!)
- ✅ Apply the recommended configuration
- ✅ Create a backup of existing settings
- ✅ Provide desktop notification setup options

⚙️ Option 2: Manual Installation

1. Choose your configuration file:
   - macOS: recommended/recommended.macos.json
   - Linux: recommended/recommended.linux.json
   - Windows: recommended/recommended.windows.json

2. Copy to Claude settings:

3. Test the configuration:

🎨 Configuration

🔵 Minimal — Built-in Simplicity

Perfect for: Users who want instant notifications with zero setup.

Features:
- ✅ 5-second setup - Just run one command
- ✅ Works everywhere - Universal terminal bell
- ✅ Zero dependencies - Nothing to…