needs-you

by Oguz Oral · ★ 0 · updated 3 days ago

BandsGuardsCommandsPromptvalidates

0

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.

install needs-you

Install

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

Then run /reload-plugins or start a new session. Requires Claude Code 2.1.287+.

View source on GitHub

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.startsession.endcommand.runprompt.editprompt.submitturn.completeclassic.PermissionRequestclassic.PostToolUseclassic.PostToolUseFailuretool.callturn.stepturn.abortui.render
API calls
$.clock.after$.clock.every$.clock.now$.command.register$.env.get$.fs.read$.process.run$.session.id$.session.root$.session.surfaces$.state.get$.state.set$.store.delete$.store.get$.store.set$.ui.log$.ui.resolve$.ui.toast
Draws
AbovePrompt
Can see
every promptclassic hooksExitPlanMode callsAskUserQuestion calls
Reach
level 2 of 3 other: $.state.getother: $.state.setruns processesreads filesreads env varspersists statedraws

Origin

How it got here
Automated scan of public GitHub repos, via the CC0 dataset awesome-claude-code-mods (scan of ).
Repository
github.com/ozlar34/claude-code-mods
Path in repo
needs-you
Author
Oguz Oral @ozlar34
License
MIT
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 ozlar34/claude-code-mods

burn-guard

ozlar34/claude-code-mods

Guards the 5h usage window: caps expensive-tier spawns per turn, keeps Fable spawns manual-only, draws a colour-coded usage gauge above the prompt (5h bar, reset time, turn burn, cache warmth, context size), and offers handoff + clear past a context size.

★ 0BandsStatus lineGuards

outward-gate

ozlar34/claude-code-mods

Confirm dialog before outward-facing sends and out-of-vault deletes; off switch for unattended runs; always-on audit log.

★ 0BandsStatus lineGuards