how it works

Three Hooks, Zero Config

Claude Code fires lifecycle hooks at key moments. The notifier catches them and sends native macOS notifications through terminal-notifier.

✋

Stop — Needs Input

hooks.Stop

Fires when Claude stops and needs your attention. A question, a decision, or approval to proceed.

🔔

Claude Code

Claude needs your attention

now

✅

Notification — Task Done

hooks.Notification

Fires when Claude sends a status update. Long builds, test runs, deploys — you'll know when they finish.

🔔

Claude Code

Task update

now

🛡️

PreToolUse — Custom

hooks.PreToolUse

Advanced: trigger notifications before specific tools run. Git pushes, file deletes, or any tool you want to audit.

🔔

Claude Code

git push detected

now

install

One Command. Done.

Installs terminal-notifier, patches your Claude settings, and tests the notification. Takes about 10 seconds.

Terminal — claude-notifier-install.sh

config

What Gets Added

The installer adds two entries to your ~/.claude/settings.json hooks. Your existing hooks stay untouched.

~/.claude/settings.json — hooks section

matcher: ""

Empty matcher means "match everything" — the hook fires for all events of that type, not filtered to a specific tool.

-sound Purr

The default notification sound. Change it to Glass, Ping, Pop, Basso, Hero, or Morse in your settings file.

Non-destructive

The installer uses jq to merge — it won't overwrite your existing hooks, Matrix BG triggers, or MCP servers.

customize

Make It Yours

Edit ~/.claude/settings.json to change sounds, messages, or add your own hook triggers.

🐱

Purr

Soft, subtle. The default. Great for focus mode.

-sound Purr

🔮

Glass

Classic macOS chime. Clean and distinctive.

-sound Glass

🏓

Ping

Short and sharp. Hard to miss.

-sound Ping

💥

Pop

Light bubble pop. Playful but noticeable.

-sound Pop

🎺

Hero

Triumphant fanfare. For when the build passes.

-sound Hero

📡

Morse

Rhythmic dots and dashes. Retro and distinct.

-sound Morse

🎵

Basso

Deep, resonant tone. Impossible to ignore.

-sound Basso

✉️

Custom Message

Change the notification text to anything.

-message 'Your text'

ClaudeNotifier

Three Hooks, Zero Config

One Command. Done.

What Gets Added

Make It Yours

Claude
Notifier