claude-notifications

Claude Notifications Plugin

Table of Contents

• Claude Notifications Plugin
  • Table of Contents
  • Features
  • Test Coverage
  • Notification Statuses
  • Installation
    • Quick Install from GitHub
    • Local Installation (for development)
  • Quick Setup (Recommended)
    • Interactive Setup Wizard
  • Manual Setup (Advanced)
    • 1. Copy Configuration File
    • 2. Configure Notifications
    • 3. Configure Sound Files (Optional)
      • Option A: Use System Sounds (Easiest - Works Immediately)
      • Option B: Add Custom Sound Files
      • Option C: Disable Sounds
  • Configuration Options
    • Desktop Notifications
    • Webhook Notifications
      • Text Format
      • JSON Format
    • Status Customization
  • How It Works
    • Status Detection Logic
      • 1. Instant Detection (PreToolUse Hook)
      • 2. Post-Completion Detection (Stop/SubagentStop Hooks)
    • Summarization
  • Limitations
    • What Can Be Tracked
    • What Cannot Be Tracked
      • Why This Happens
      • Workaround
  • Platform Support
    • Fully Supported Platforms
    • Cross-Platform Implementation
    • macOS-Only Features
    • Requirements
  • 🔔 Webhook Integrations
    • Quick Start
    • Available Presets
  • Known Issues
    • Duplicate Notifications (Claude Code Bug)
    • Summary Text Robustness
  • Troubleshooting
    • Notifications not appearing
    • Sounds not playing
    • Webhook not working
  • Contributing
  • License
  • Support
  • Roadmap

Smart notifications for Claude Code task statuses with desktop notifications, webhooks, and sound alerts.

Features

• ✅ Desktop Notifications - Native notifications on macOS, Linux, and Windows
• 🔔 Sound Alerts - Customizable sounds for different status types
• 🌐 Webhook Integration - Send notifications to external services (text or JSON)
• 🎯 Smart Status Detection - Automatically detects task completion, reviews, questions, and plan readiness
• 📝 Auto Summarization - Generates concise summaries of completed tasks
• 🔧 Highly Configurable - Customize everything through a simple JSON config
• 🚀 Zero Dependencies - Works out-of-the-box on Windows without installing jq (uses built-in PowerShell)

Test Coverage

This plugin has comprehensive test coverage: