Claude Code mod

needs-you

CC Alerts: pings you (macOS banner + sound) when a session finishes a long turn or sits blocked on a dialog, only as loudly as needed given whether you're already looking. /ping controls quiet modes.

Notification & sound modsValidates on Claude Code 2.1.316 Source

Install

From source
git clone https://github.com/ozlar34/claude-code-mods.git
claude --plugin-dir ./claude-code-mods/needs-you

The repo has no marketplace file, so load the plugin folder directly with --plugin-dir.

What it can access

Reach
L2Writes or runs: runs processes, reads files, reads env vars, reads mod state, persists state, draws
Sees
every prompt, classic hooks, ExitPlanMode calls, AskUserQuestion calls
Draws in
AbovePrompt
Hooks
session.startsession.endcommand.runprompt.editprompt.submitturn.completeclassic.PermissionRequestclassic.PostToolUseclassic.PostToolUseFailuretool.callturn.stepturn.abortui.render

From a static scan of the mod's code by awesome-claude-code-mods. It shows what the code asks for, not a security review.

How Claude Code mods work

  • A mod is a plugin with a JavaScript or TypeScript module that runs inside Claude Code (version 2.1.287 or later). It can draw panes beside the transcript, a band above the prompt, buttons and toasts, restyle the spinner and tool rows, and watch or rewrite tool calls and prompts.
  • It installs like any plugin: add its marketplace with /plugin marketplace add owner/repo, then /plugin install name@marketplace.
  • Check what a mod can reach before installing: it runs with your permissions. Reach goes from drawing only, to reading files, to writing files or running processes, to the network. Run claude plugin validate on a clone to list its hooks and calls without running it.
  • Turn one off from the Installed tab in /plugin, or start Claude Code with --safe-mode to skip every customization for a session.
Claude Code docs

Details

Repository
ozlar34/claude-code-mods
Folder
needs-you
Author
Oguz Oral
Type
Notification & sound mods
License
MIT
Last updated
2 October 2026
Listed in
awesome-claude-code-mods

FAQ

What is needs-you?

CC Alerts: pings you (macOS banner + sound) when a session finishes a long turn or sits blocked on a dialog, only as loudly as needed given whether you're already looking. /ping controls quiet modes. It is a mod for Claude Code, from ozlar34/claude-code-mods on GitHub.

What can the needs-you mod access?

Its widest reach is "writes or runs" (runs processes, reads files, reads env vars, reads mod state, persists state, draws). It sees every prompt, classic hooks, ExitPlanMode calls, AskUserQuestion calls. It draws in AbovePrompt. Like any mod, it runs with your permissions.

How do I install needs-you?

Clone ozlar34/claude-code-mods and start Claude Code with --plugin-dir pointing at the mod's folder (needs-you).

More notification & sound mods

narrator

adayarabov/narrator

Claude talks to you while it works: spoken narration in a browser page, and a voice side chat that answers questions and passes instructions without interrupting the task

Notification & sound mods/plugin install

next-steps

humvnpvrvdox777/NextSteps

Three next steps after each answer, above your prompt. An optional local voice reads them aloud, and a side assistant helps you decide the next request.

Notification & sound mods/plugin install

mya

xaiksan1/modnest

MYA: a voice for Claude Code on Linux/X11. Tap Right Ctrl to talk, Right Ctrl + Space to translate, and MYA answers aloud, with a ringing phone when it is your turn.

Notification & sound mods

no-hands

elparko/look-claude-no-hands

Hands-free voice mode for Claude Code on Apple Silicon Macs: talk any time, hear short spoken replies, interrupt or add to work mid-task, run slash commands, and message or stop subagents by voice. Speech runs locally with Whisper and Kokoro.

Notification & sound mods/plugin install

model-router

sftinc/claude-code-model-router

Routes each turn and subagent to a model tier and reasoning effort using a classifier behind any server that speaks POST /v1/classify (model-router-api on Cloudflare Workers AI today), falling back to the engine's built-in classifier.

Notification & sound mods/plugin install

notify

StanislavKozachenko/claude-mods

Notifications that say what happened: a long turn finished (with its answer), a permission prompt or a question waiting, an Actions budget running low; on the desktop and, through Claude Code push, on your phone

Notification & sound mods

Browse the most popular Claude Code mods, all notification & sound mods, or the skills and MCP server directories.