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.

• Project-scoped Claude hooks now override the global mute file correctly: cn off can still mute global notifications instantly, but cnp on project hooks continue to work for that project
• Project commands are now consistent with .claude/settings.json: cnp on, cnp off, and cnp status all use the current project settings format instead of mixing in legacy hooks.json assumptions
• Regression coverage now guards both project bugs: the test suite now checks project kill-switch behavior and project settings.json consistency end to end

• Multi-tool support - Claude Code, OpenAI Codex, Google Gemini CLI
• Works everywhere - Terminal, VSCode, Cursor, or any editor
• Cross-platform - macOS, Linux, Windows
• Native notifications - Uses system notification APIs
• Sound notifications - Play custom sounds on task completion
• Voice announcements - Hear when tasks complete (macOS, Windows)
• Tool-specific messages - "Claude completed the task", "Codex completed the task"
• Project-specific settings - Different configs per project
• Quick aliases - cn and cnp for fast access

macOS (Homebrew)

brew tap mylee04/tools brew install code-notify cn on

macOS (Homebrew, Already Installed)

cn update code-notify version

If you were using the older claude-notify hook layout, supported upgrades now repair those Claude hooks automatically. On Windows, that repair also covers older notify.ps1 hook layouts and alternate Claude settings locations such as %USERPROFILE%\.config\.claude\settings.json.

Linux / WSL

curl -sSL https://raw.githubusercontent.com/mylee04/code-notify/main/scripts/install.sh | bash

npm (macOS / Linux / Windows)

npm install -g code-notify cn on

Windows

irm https://raw.githubusercontent.com/mylee04/code-notify/main/scripts/install-windows.ps1 | iex

Paste this to your AI agent (Claude Code, Cursor, etc.):

Install code-notify by following: https://raw.githubusercontent.com/mylee04/code-notify/main/docs/installation.md 

Or fetch directly:

curl -s https://raw.githubusercontent.com/mylee04/code-notify/main/docs/installation.md

When enabling project notifications with cnp on, Code-Notify warns if Claude project trust does not appear to be accepted yet. Project-scoped Claude hooks override the global mute file, so cn off will not suppress a project where cnp on is enabled. all is also accepted as an explicit alias for global commands such as cn on all, cn off all, and cn status all.

Code-Notify uses the hook systems built into AI coding tools:

• Claude Code: ~/.claude/settings.json
• Codex: ~/.codex/config.toml
• Gemini CLI: ~/.gemini/settings.json

For Codex, Code-Notify configures notify = ["/absolute/path/to/notifier.sh", "codex"] and reads the JSON payload Codex appends on completion. Codex currently exposes completion events through notify; approval and request_permissions prompts do not currently arrive through this hook.

When enabled, it adds hooks that call the notification script when tasks complete:

{ "hooks": { "Stop": [ { "matcher": "", "hooks": [{ "type": "command", "command": "notify.sh stop claude" }] } ], "Notification": [ { "matcher": "idle_prompt", "hooks": [ { "type": "command", "command": "notify.sh notification claude" } ] } ] } }

By default, notifications only fire when the AI is idle and waiting for input (idle_prompt). You can customize this:

cn alerts # Show current config cn alerts add permission_prompt # Also notify on tool permission requests cn alerts remove permission_prompt # Remove permission notifications cn alerts reset # Back to default (idle_prompt only)

Alert-type matching currently applies to Claude Code and Gemini CLI notification hooks. Codex currently uses completion events from notify, so permission_prompt and idle_prompt settings do not change Codex behavior.

Command not found?

exec $SHELL # Reload shell

No notifications?

cn status # Check if enabled cn test # Test notification brew install terminal-notifier # Better notifications (macOS)

Installed with npm?

cn update # Runs: npm install -g code-notify@latest

code-notify/ ├── bin/ # Main executable ├── lib/ # Library code ├── scripts/ # Install scripts ├── docs/ # Documentation └── assets/ # Images 

• Installation Guide
• Hook Configuration
• Contributing
• GitHub Issues

MIT License - see LICENSE