notify
by Steve Godin · ★ 0 · updated yesterday
Tells you when Claude needs you, finishes a long turn, nears a rate limit, finishes a background task or is still working: as a desktop notification (clicking it brings you to the session's tab) and, with the say mod, out loud
Install
/plugin marketplace add whilestevego/claude-mods/plugin install notify@claude-modsThen run /reload-plugins or start a new session. Requires Claude Code 2.1.287+.
What it hooks into
From an automated scan with claude plugin validate, not a security review. Mods run with your permissions; read the code before installing.
- Events
session.startcommand.runprompt.submittool.calltool.checkturn.completesession.measure- API calls
$.clock.every$.clock.sleep$.command.register$.config.list$.env.get$.fs.read$.model.complete$.process.run$.state.get$.store.get$.store.set$.ui.notify$.ui.toast$.voice.say- Can see
every promptAskUserQuestion callsevery tool call- Reach
- level 2 of 3 runs processesdrives Claudereads filesreads env varsreads settingsreads mod statepersists statedrawsother: $.voice.say
Origin
- How it got here
- Automated scan of public GitHub repos, via the CC0 dataset awesome-claude-code-mods (scan of ).
- Repository
- github.com/whilestevego/claude-mods
- Path in repo
notify- Source commit
e180621the exact code the scan read- Author
- Steve Godin @whilestevego
- License
- No license declared — ask the author before reusing code.
- First published
- Last pushed
- First listed here
Name and description come from the mod's own manifest. We link to the code; we don't host it, and it stays under its author's license.
More from whilestevego/claude-mods
context-bar
whilestevego/claude-mods
Context window as a stacked bar above the prompt, toggled with /context-bar
ghostty
whilestevego/claude-mods
Ghostty integration: a 4-word summary as the tab title (/title for a new one now), a tab progress bar, ❓ when Claude waits on you (the notify mod sends the notification), /goto between Claude sessions (waiting ones first), /workspace to save and reopen windows of sessions, and /keybind for Ghostty keys that type into Claude
rate-limits
whilestevego/claude-mods
5-hour and weekly rate-limit gauges above the prompt, with a warning at 90%
say
whilestevego/claude-mods
Claude Code's voice, through murmur (Kokoro on the Apple Neural Engine): each session in its own voice (/say picks one), /say read and /say tldr, and $.voice.say for other mods; the notify mod decides what gets said
session-id
whilestevego/claude-mods
Shows the session id in the prompt footer; click to copy
tldr
whilestevego/claude-mods
A one-line TL;DR under Claude's long replies, written by Claude Haiku; the notify mod uses the same line as its turn summary
turn-receipt
whilestevego/claude-mods
A receipt row above the prompt after each turn: time, tools, files edited, cost