Vibeleaderboard
Index / tool
Visit github.com
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 eventsmacOS desktop notifications

  • Surface background agent activity to user attention

    Running Claude Code agent processesVisible notification alerts

  • Monitor Claude Code agent status changes

    Agent state transitions and updatesReal-time notification updates

  • Bridge Claude Code events to macOS notification system

    Internal Claude Code event dataNative macOS notification format

Tags

claude-codemacosnotificationsswift

Tech Stack

Node.jsSwiftTypeScript

Comments (0)

No comments yet

Editorially curated, with community endorsements as a secondary signal. Corrections welcome.