Claude Code mod
agent-usage-guard
A Claude Code mod that holds subagent fan-out, heavy-context prompts and retry loops before they spend your usage window. It reads your plan's usage, counts agents across every session, and asks in Claude Code's own dialog.
Install
/plugin marketplace add rbartoli/agent-usage-guard
/plugin install agent-usage-guard@agent-usage-guardMods install like plugins. Run /reload-plugins or start a new session to load it.
What it can access
- Reach
- L2Writes or runs: drives Claude, reads files, reads env vars, persists state, draws
- Sees
- classic hooks, every prompt, subagent spawns, every tool call
- Hooks
session.startclassic.SessionStartclassic.UserPromptSubmitclassic.PostToolUseclassic.PostCompactclassic.Stopclassic.SubagentStartclassic.StopFailuresession.endsession.measureturn.stepturn.completeprompt.submitagent.spawntool.callcommand.run
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.
Details
- Repository
- rbartoli/agent-usage-guard
- Folder
.- Marketplace
agent-usage-guard- Author
- Riccardo Bartoli
- License
- MIT
- Last updated
- 1 November 2026
- Listed in
- awesome-claude-code-mods
FAQ
What is agent-usage-guard?
A Claude Code mod that holds subagent fan-out, heavy-context prompts and retry loops before they spend your usage window. It reads your plan's usage, counts agents across every session, and asks in Claude Code's own dialog. It is a mod for Claude Code, from rbartoli/agent-usage-guard on GitHub.
What can the agent-usage-guard mod access?
Its widest reach is "writes or runs" (drives Claude, reads files, reads env vars, persists state, draws). It sees classic hooks, every prompt, subagent spawns, every tool call. Like any mod, it runs with your permissions.
How do I install agent-usage-guard?
Inside Claude Code (v2.1.287 or later), run /plugin marketplace add rbartoli/agent-usage-guard and then /plugin install agent-usage-guard@agent-usage-guard.
Is agent-usage-guard popular?
rbartoli/agent-usage-guard has 90 GitHub stars and 0 forks, and is included in 1 curated Claude Code list. It was last updated on 1 November 2026.
More context & usage mods
effortless
305HeyCubit/effortless
Sets the reasoning effort for every prompt automatically, shows it under the prompt box, and counts down how long the prompt cache stays warm.
transcripted-live
89r3dbars/transcripted
The meeting Transcripted is recording, inside Claude Code: Claude gets the call as context, a live dashboard (now, asked of you, action items), prompt suggestions for questions aimed at you, and an after-call wrap-up that gains speaker names once Transcripted saves the meeting. Needs the transcripted-live helper running.
winnow
115GhalebDweikat/winnow
A calibrated context sieve for Claude Code. Every large tool result is judged by a System One model before it enters context; irrelevant blocks are replaced with a summary and a recall key.
archcore
73archcore-ai/archcore
Spec-driven development and context engineering for AI coding agents, backed by project context in Git.
session-band
317JohnnyVizz/claude-kit
Band above the prompt: turn number, output speed, turn and session cost, prompt cache countdown and context fill; notifies before the cache expires.
cache-keeper
68nateherkai/claude-code-mods
Keeps a big chat's prompt cache warm, warns before an expensive cold restart, shows every local chat on one board (/board), and hands a chat off to a fresh one (/handoff)
Browse the most popular Claude Code mods, all context & usage mods, or the skills and MCP server directories.