
Claude Notify
https://github.com/badlogic/claude-notify- Category
- Developer Tools
- Rank
- No. 2106Tools index
Previous survey · No. 2101 ·
- Pricing
- Open Source
- Type
- TOOL
- Builder
- badlogic
- GitHub
- 12 stars
- Date
About
macOS notification helper for Claude Code, surfaces agent events to the desktop.
What it does
Claude Notify wires command hooks into Claude Code, reads each event and its conversation transcript, then alerts you when attention is needed. On macOS, a background menu bar app tracks multiple sessions and their working or waiting state. Linux and Windows receive stop and notification alerts with sound.
Why it's ranked here
This is a focused utility with unusually useful multi-session handling on macOS. Automatic hook setup, transcript-aware messages, per-session muting, and a waiting count address real unattended-agent friction. Its weaker cross-platform experience and unfinished daemon testing keep the verdict measured.
What's good
Installation and removal manage all five supported hook events automatically. Notifications include the working directory and latest assistant text, which helps identify the waiting task without reopening every terminal. The macOS control center tracks active sessions, sorts waiting work first, marks dead processes, records working time, and supports per-session muting.
Tradeoffs
The richer control center exists only on macOS. Linux and Windows alert only for stop and notification events, while Linux also requires notify-send. The daemon lacks an implemented testing approach, and focusing the originating terminal window remains unfinished. Transcript parse failures fall back poorly because later code still assumes at least one parsed entry exists.
How to use it well
It suits developers who run Claude Code tasks in the background or juggle several sessions, especially on macOS. Install the hooks globally, run the built-in notification test, and mute individual sessions when needed. Disable it per session for quiet work. It does not manage tasks, restore terminal focus, or provide a general automation framework.
Technical notes+
src/cli.ts exposes the command-line interface, accepts hook JSON on stdin, and supports installation, removal, testing, and help. src/settings.ts edits the user-level Claude settings to register PreToolUse, PostToolUse, Stop, SubagentStop, and Notification commands. src/transcript.ts parses JSONL transcripts for context, but indexes the final entry even after parsing returns an empty array. src/notifications.ts routes macOS events through src/daemon-client.ts; other platforms use node-notifier and src/sound.ts. The Swift daemon in src/mac/daemon.swift receives newline-delimited JSON over a Unix socket, tracks process state, and emits native notifications. docs/todo.md explicitly leaves daemon testability and terminal-window focusing unfinished.
Observed
- License
- MIT
- Implementation languages
- TypeScript for the CLI and shared logic; Swift for the macOS daemon
- Installation surface
- Global npm package named @mariozechner/claude-notify
- Interface
- Command-line hook handler that reads JSON from standard input
- Runtime requirement
- Node.js 18 or newer
- Platform support
- macOS, Linux, and Windows; the menu bar daemon and control center are macOS-only
- Hook coverage
- PreToolUse, PostToolUse, Stop, SubagentStop, and Notification
- Linux dependency
- Desktop notifications require notify-send
Read from README.md, package.json, src/cli.ts, src/sound.ts, src/logger.ts, src/settings.ts, src/transcript.ts, src/daemon-client.ts, src/notifications.ts, src/mac/daemon.swift, src/mac/BridgingHeader.h, docs/todo.md, docs/build.md, docs/hooks.md, docs/backlog.md.
What it can do
Display Claude Code agent events as desktop notifications
Claude Code agent events → macOS desktop notifications
Surface background agent activity to user attention
Running Claude Code agent processes → Visible notification alerts
Monitor Claude Code agent status changes
Agent state transitions and updates → Real-time notification updates
Bridge Claude Code events to macOS notification system
Internal Claude Code event data → Native macOS notification format
Tags
Tech Stack
Comments (0)
No comments yet
Editorially curated, with community endorsements as a secondary signal. Corrections welcome.