ClaudeNotifier

ClaudeNotifier

  A macOS notification app for Claude Code integration.
  Displays native notifications and focuses the correct terminal tab when clicked.

  Why? •
  Features •
  Installation •
  Usage •
  FAQ

✨ Why ClaudeNotifier?

Anthropic's recommended terminal notification setup only works for iTerm2 users (also I could never make it work on my machine). ClaudeNotifier provides a reliable alternative that supports multiple terminals and editors, with extra features like click-to-focus and smart suppression.

Most other notification setups rely on terminal-notifier or osascript one-liners. ClaudeNotifier takes a different approach:

- 📦 Zero dependencies: Just install and run claude-notifier setup.
- 🎯 Click-to-focus the exact tab: Other tools open the app at best. ClaudeNotifier focuses the specific terminal tab or iTerm2 session that triggered the notification.
- 🤫 Smart suppression: Notifications are silenced when you're already looking at the terminal, so you're not interrupted mid-thought. Orchestrated sessions (Conductor, Agent SDK apps) and headless (claude -p) sessions are also suppressed by default.
- 🧹 No notification spam: Each terminal tab and project keeps at most one notification in Notification Center. New notifications replace old ones instead of piling up.
- 🖥️ Wide terminal support: iTerm2, Terminal.app, Ghostty, Warp, VS Code, VSCodium, Cursor, Windsurf, Zed, WebStorm, and IntelliJ IDEA.
- 🩺 Built-in diagnostics: claude-notifier doctor checks your installation, hooks, permissions, and PATH so you can fix issues without guesswork.
- 💅🏻 A pretty icon: Look, someone spent way too long on it. Might as well enjoy it.

📦 Installation

Quick Install (Recommended)

Homebrew

🚀 Usage

Quick Setup for Claude Code

You'll be prompted for the…