CCNotify

CCNotify

CCNotify provides desktop notifications for Claude Code, alerting you when Claude needs your input or completes tasks.
Important Notes
Starting from claude-code v1.0.95 (2025-08-31), any invalid settings in ~/.claude/settings.json will disable hooks. See Why not working for solutions.

Features

- 🔔 Get notified when Claude requires your input or completes a task.
- 🔗 Click to jump back when notifications are clicked, automatically taking you to the corresponding project in VS Code.
- ⏱️ Task Duration: Displays started time, and how long the task took to complete

Note: Currently compatible with macOS only.

Installation Guide

1. Install CCNotify

2. Install terminal-notifier
ccnotify uses terminal-notifier for macOS notifications. Install it using Homebrew:

For alternative installation methods and more information, visit: https://github.com/julienXX/terminal-notifier

3. Configure Claude Hooks
Add the following hooks to your Claude configuration to enable ccnotify:

 ~/.claude/settings.json

Try It Out

To verify the notification system works, start a new Claude Code session and run:

You should see a macOS notification appear.

Why not working
1. Ensure hooks configuration is active. Here's an example where other configurations prevent hooks from working:

claude -p --model haiku -d hooks --verbose "hi"

Expected output:

Actual output:

Reason: In September 2025, claude-code strengthened validation rules for settings.json. Any invalid configuration will disable hooks.
You need to modify the relevant configurations in ~/.claude/settings.json until the Invalid settings error stops appearing.

How It Works

ccnotify tracks Claude sessions and provides notifications at key moments:

- When you submit a prompt: Records the start time and project context
-…