usage-guard

by Aliaksei Loi · ★ 0 · updated 3 days ago

BandsGuardsCommandsvalidates

0

Winds sessions and subagents down before the 5-hour or 7-day subscription limit: one wind-down note per band, a handoff file, spawn and loop denies near the limit, optional resume after the reset

install usage-guard

Install

/plugin marketplace add aliaksei-loi/usage-guard
/plugin install usage-guard@usage-guard

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.measuretool.callagent.spawnturn.completeclassic.StopFailurecommand.runui.render
API calls
$.agent.list$.clock.after$.clock.every$.clock.now$.command.register$.env.get$.fs.exists$.fs.write$.prompt.submit$.session.append$.session.id$.session.messages$.session.root$.session.usage$.state.get$.state.set$.ui.log$.ui.resolve$.ui.toast
Draws
AbovePrompt
Can see
every tool callsubagent spawnsclassic hooks
Reach
level 2 of 3 other: $.state.getother: $.state.setwrites filesdrives Claudereads filesreads env varsreads the transcriptdraws

Origin

How it got here
Automated scan of public GitHub repos, via the CC0 dataset awesome-claude-code-mods (scan of ).
Repository
github.com/aliaksei-loi/usage-guard
Path in repo
repository root
Source commit
15222c1 the exact code the scan read
Author
Aliaksei Loi @aliaksei-loi
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.