Claude Code notification

code-notify

Cross-platform desktop notifications for Claude Code, Codex and Gemini CLI.

Install

Install
npm install -g code-notify
From source
git clone https://github.com/mylee04/code-notify.git

From the README

Code-Notify
Official downloads: https://github.com/mylee04/code-notify/releases
Homebrew: brew install mylee04/tools/code-notify
npm: npm install -g code-notify

Desktop notifications for AI coding tools - get alerts when tasks complete or input is needed.

Latest: Advance Usage Reset Reminders

On macOS/Linux (including WSL), Code-Notify can now remind you before Codex or Claude usage resets, using the existing usage watcher and notification channels.

- Default schedule: Weekly reminders at 48h, 24h, 12h, 6h, 2h, and 30m; 5h windows use 2h and 30m
- Once per reset cycle: Full-quota observations do not erase previously sent reminders
- Quiet catch-up: Missed stages collapse into the most urgent reminder for each window
- Configurable: Choose your own schedule with cn usage reset-reminders set 24,6,1, or disable it with cn usage reset-reminders off

Update and verify the installed version:

v1.13.1 maintenance fix: cn status no longer reports REPAIR NEEDED for the current Claude ask_user hook format, while genuine legacy hooks remain repairable.

Usage alerts remain opt-in: start with cn usage setup --watch. Existing enabled usage configs without a reset_reminders setting use the default reminder schedule. After updating, restart any running watcher with cn usage watch restart (include your provider and interval options if customized).

Voice samples: Daily reset · Weekly reset

What's New in v1.13.1

- Accurate Claude status: Current ask_user hooks using PreToolUse claude are recognized as enabled instead of legacy
- No repair loop: Re-running cn on claude is no longer suggested for a configuration Code-Notify just installed
- Legacy compatibility retained: Older PreToolUse commands without the Claude tool argument are still detected for repair

Features

- Multi-tool…
Read the full README on GitHub

Details

Language
Shell
License
MIT
Last updated
4 September 2026
Topics
anthropic-claudeclaudeclaude-limit-reset-notifiercodexcodex-clicodex-limit-reset-notifierdesktop-notificationsdeveloper-toolsgeminigoogle-geminihomebrewlinux

FAQ

What is code-notify?

Cross-platform desktop notifications for Claude Code, Codex and Gemini CLI. It is a notification for Claude Code, from mylee04/code-notify on GitHub.

How do I install code-notify?

Run npm install -g code-notify, then follow the setup in the README.

Is code-notify popular?

mylee04/code-notify has 289 GitHub stars and 25 forks. It was last updated on 4 September 2026.

More notifications & sounds

Browse the most popular Claude Code mods, all notifications & sounds, or the skills and MCP server directories.