claude-notify

Claude-notify

A simple, cross-platform notification system to alert you when Claude needs your attention.

Features

- 🖥️ Cross-platform support: Works on macOS, Linux, and Windows
- 🔔 Native notifications: Uses system-native notification methods when available
- 🪝 Claude Code hooks: Integrates seamlessly with Claude's hook system
- ⚙️ Configurable: Customize notification preferences
- 🎯 Simple CLI: Easy-to-use command-line interface
- 🔄 Watch mode: Continuous monitoring with periodic notifications
- 🚨 Smart alerts: Critical notifications for potentially destructive operations
- 📁 Project identification: All notifications include project name and path

Installation

From Source

Using pip (when published)

Usage

Claude Code Hook Integration (Recommended)

Claude-notify can be integrated directly with Claude Code as a hook to notify you when Claude needs attention or performs certain actions.

Setting up as a Claude Hook

You can configure claude-notify as a hook in two ways:

Option 1: Using Claude's /hooks command (Recommended)

Option 2: Manual configuration

Add to your Claude settings file (~/.claude/settings.json or .claude/settings.json in your project):

This configuration will:
- Notify you when Claude finishes responding (Stop event)
- Alert you before Claude uses potentially destructive tools (Bash, Write, Edit, MultiEdit)
- Show the project name in ALL notification titles and full project path in ALL messages

Available Hook Events

- PreToolUse: Before Claude uses a tool (can be used to review/block actions)
- PostToolUse: After a tool completes successfully
- Notification: When Claude sends a notification
- Stop: When Claude finishes responding
- SubagentStop: When a Claude subagent completes

Testing Hook Integration

Project Path Display

For…