claudecodenotify

ClaudeCodeNotify

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

A macOS menu bar app that pops a floating notification in the center of your screen when Claude Code needs you — when it asks for permission, is idle waiting for input, or finishes a task. Press Enter (or click) and it jumps you straight to the terminal where Claude is running. Built for people who leave Claude Code working and don't want to babysit the terminal.
It's a notifier, not a gatekeeper. It doesn't block tools or decide permissions — you still approve/deny in the terminal. It just makes sure you *notice* and gets you there fast.

  🌐 claudecodenotify.narlei.com

Contents

- How it works
- Features
- Installation
- First launch
- Build (development)
- Distribution
- Support
- License

How it works

When shown, the notification appears centered at the top, over anything (including fullscreen apps), and captures the keyboard so a single Enter takes you to Claude. Esc, a click, or the per-type timeout dismisses it. Nothing is blocked — Claude keeps showing its native prompt in the terminal; this just gets you there.

Features

- 🔔 Three event types, each with its own icon and color:
  - 🟠 Claude needs permission
  - 🟡 Claude is idle (waiting for input)
  - 🟢 Claude finished the task (shows a short summary)
- ↵ Enter → jump to the terminal — detects the host app (Ghostty, iTerm, Terminal, Cursor, VS Code, WezTerm, …) via $TERM_PROGRAM and brings it to the front.
- 🎚️ Make it yours — per-type duration (0 = stays until dismissed) and sound (system sounds or none, with preview); plus how the card/sound behaves while Claude's terminal or editor is already focused.
- 📊 Lives in your menu bar — a bell icon with a green/red connection dot; connect or…