Claude Code Notify

claude-code-notify

The simplest Claude Code notification. One command. One bash script. No binaries.

[](https://opensource.org/licenses/MIT) []() []() []()

Get notified when Claude Code finishes responding — with sound, notification banner, or both.

Install

git clone https://github.com/yagcioglutoprak/claude-code-notify.git /tmp/claude-code-notify && /tmp/claude-code-notify/install.sh && rm -rf /tmp/claude-code-notify

Features

• Smart debounce — only notifies when Claude is truly done, not between tool calls
• Focus detection — stays silent when your terminal is focused
• Rich banners — Claude icon, elapsed time, title/subtitle via terminal-notifier
• Elapsed time — shows how long the response took ("Completed in 45s")
• Zero config — works out of the box, customize if you want
• Fallback — uses basic osascript if terminal-notifier isn't installed

Why this one?

Other notification tools require Go binaries, Rust compilation, or dozens of config files. This is **one bash script** with smart debounce — it just works.

Feature	claude-code-notify	Others
Install	One command	Build from source / cargo install / go install
Dependencies	jq (likely already installed)	Go / Rust / Node.js runtimes
Size	Single bash script	Full binary or multi-file projects
Debounce	Built-in (no false pings mid-response)	Most lack this
Focus detection	Skips notification if terminal is focused	Not available
Rich banners	Claude icon + elapsed time	Plain text
Config	One