ClaudeCodeNotify app icon: a coral squircle with a white bell and a sparkle

ClaudeCodeNotify

Desktop notifications when Claude Code needs you — one keystroke back to your terminal.

Download for macOS Buy me a coffee ☕

macOS 13+ · Apple Silicon · free & open source

Three ClaudeCodeNotify notification cards: Claude needs permission, Claude is waiting for you, and Claude finished — each showing a keystroke to return to the terminal.

It’s a notifier, not a gatekeeper. It doesn’t block tools or decide permissions — you still approve or deny in the terminal. It just makes sure you notice, and gets you there fast.

Everything it does

  • Get notified

    A floating notification appears when Claude asks for permission, goes idle waiting for input, or finishes a task.

  • Enter → jump to your terminal

    Detects the exact app Claude runs in — Ghostty, iTerm, Terminal, Cursor, VS Code — and brings it to the front.

  • Make it yours

    Set how long each notification stays on screen and which sound plays — pick a system sound, or none at all.

  • Lives in your menu bar

    A bell icon with a connection status dot. Connect or disconnect anytime — no Dock icon, no clutter.

  • Local & private

    A tiny local server on 127.0.0.1 with a token. Nothing leaves your machine.

  • Free & open source

    MIT-friendly and fully on GitHub. Read the code.

See it in action

The ClaudeCodeNotify welcome window explaining its four features, with a 'Claude Code connected' banner and a Get Started button.
First-launch onboarding walks you through setup and confirms the connection.
The menu bar dropdown showing a green 'Claude Code: connected' status, with Disconnect, Welcome, Preferences, Open at Login, a Support ClaudeCodeNotify submenu, and Quit.
The menu bar menu, with a green/red connection status dot.
The three notification types: permission request, idle waiting, and finished task.
The three notification types — permission, idle, and finished.

Download

Ships as a drag-to-Applications .dmg (or .zip) from GitHub Releases.

Get it on GitHub Releases

First launch (unsigned app)

The app is ad-hoc signed (no paid Apple account), so Gatekeeper will warn you the first time. Either right-click → Open, or clear the quarantine flag:

xattr -dr com.apple.quarantine /Applications/ClaudeCodeNotify.app

Requirements: macOS 13+, Apple Silicon.

Support the project

ClaudeCodeNotify is free and open source. Every little tip keeps me motivated to make the app better — thank you! 💛

Ko-fi Buy me a coffee Open Ko-fi PayPal paypal.me/narlei Open PayPal
Pix Brazil — copy the key
contato@narlei.com