notifications

Claude Notify

Never miss when Claude is waiting — get notified in the way that works for your current context.

Setup

Prerequisites

# Required: JSON parsing
brew install jq

# Recommended: Better notifications via Notification Center
brew install terminal-notifier

Without terminal-notifier, the plugin falls back to osascript (requires Script Editor notification permissions).

Installation

1. Clone or copy this plugin to your Claude Code plugins directory
2. Enable in your Claude Code settings

Configuration

Edit ~/.claude/settings.json to configure providers and events:

{
  "notifications": {
    "providers": {
      "system": { "enabled": true },
      "bell": { "enabled": false },
      "tts": { "enabled": false }
    },
    "events": {
      "permission_prompt": ["system"],
      "idle_prompt": ["system"],
      "Stop": ["system"]
    }
  }
}

Providers

Provider	Description	Dependencies
system	macOS Notification Center banners	terminal-notifier (recommended)
bell	Terminal bell sound	None
tts	Text-to-speech	macOS say command

Events

• permission_prompt — Claude needs permission to proceed
• idle_prompt — Claude is waiting for input
• elicitation_dialog — Claude is asking a question
• Stop — Agent completed
• SubagentStop — Subagent completed