claude-notification 🗣️

Fun, customizable desktop notifications for Claude Code. Never miss when Claude finishes cooking or needs your attention.

Install

npx claude-notification

That's it. The installer walks you through:

• What Claude should call you
• Pick a message pack
• Auto-detect your editor
• Where to install hooks

What It Does

Plugs into Claude Code's hook system and sends desktop notifications when:

• Claude finishes a task — "Cooked Master 🍳"
• Claude needs your input — "Master, pretty please? 🥹"

Messages are randomized. Fully customizable.

Message Packs

| Pack | Vibe | |------|------| | default | The OG (Master, done, cooked, crushed it) | | casual | Chill (Yo, it's done, EZ clap) | | formal | Corporate (Task completed, awaiting input) | | anime | Weeb (Senpai, I finished! uwu) | | pirate | Arr (The task be done, cap'n!) |

Supported Editors (auto-detected)

VS Code, Cursor, Google Antigravity, Windsurf, Zed, iTerm2, Terminal.app, Ghostty, Warp, Kitty, Alacritty

On macOS, notifications appear with your editor's icon.

Customize

Edit ~/.claude-yap/config.json:

{
  "name_prefix": "Boss",
  "message_pack": "casual",
  "sounds": { "stop": "Hero", "notification": "Submarine" }
}

Custom Messages

{
  "custom_stop_messages": ["LFG {name}! 🚀"],
  "custom_notification_messages": ["Oi {name}! Look! 📢"]
}

Available Sounds (macOS)

Basso, Blow, Bottle, Frog, Funk, Glass, Hero, Morse, Ping, Pop, Purr, Sosumi, Submarine, Tink

Uninstall

~/.claude-yap/uninstall.sh

License

MIT — by abdulrohman