ClaudeCodeNotify
Desktop notifications when Claude Code needs you — one keystroke back to your terminal.
macOS 12+ · Intel & Apple Silicon · free & open source
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.
See it in action
You prompt, Claude works, you go do something else. The moment Claude needs you, a card pops up — and Enter brings your terminal straight back.
- Floating cards when Claude asks permission, goes idle or finishes
- Enter focuses the exact app — Ghostty, iTerm, Terminal, Cursor, VS Code
- Live usage bars — 5-hour & weekly limits, color-coded with reset countdown
- Multi-account — easy switching, live usage tracking for each
- Lives in the menu bar — no Dock icon, no clutter
- Pick the duration & sound of every notification — or no sound at all
- Local & private — a tiny server on
127.0.0.1, nothing leaves your Mac - Free & open source — read the code
Download
Option 1: Homebrew (Recommended)
The easiest way to install. It bypasses Gatekeeper warnings automatically:
brew install narlei/tap/claudecodenotifyOption 2: Manual Download. Get the latest drag-to-Applications .dmg from GitHub Releases.
Download latest .dmgFirst 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.appRequirements: macOS 12+, Intel or Apple Silicon.
Enjoying ClaudeCodeNotify?
A GitHub star takes a second and helps the project reach more people. ⭐
Support the project
ClaudeCodeNotify is free and open source. Every little tip keeps me motivated to make the app better — thank you! 💛
Hey, I’m Narlei 👋
iOS & macOS developer from Brazil. I build tools that boost developer productivity and improve your app’s architecture. If ClaudeCodeNotify saves you trips to the terminal, buy me a coffee 🙏
contato@narlei.com