budget-guard
by Vedant Andhale · ★ 1 · updated 2 days ago
Holds a prompt back once your 5-hour or weekly usage is at or over a limit you set (90% by default); sending it again goes through. No tokens spent.
Install
/plugin marketplace add VedantAndhale/claude-pro-kit/plugin install budget-guard@claude-pro-kitThen 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.startsession.measurecommand.runprompt.submit- API calls
$.clock.now$.command.register$.store.get$.store.set$.ui.toast- Can see
every prompt- Reach
- level 0 of 3 persists 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/VedantAndhale/claude-pro-kit
- Path in repo
plugins/budget-guard- Author
- Vedant Andhale @VedantAndhale
- License
- MIT
- First published
- Last pushed
- First listed here
- On X
- Mentioned in 1 post on X
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.
Posts about this repo
@davekiss @jarrodwatts @ihamzafer Great i have few of my scripts doing similar with twist I will soon be getting a kit for my self as mods from my scripts. Mods has really enabled claude to make more coustom experience with llms after skills. https://github.com/VedantAndhale/claude-pro-kit
More from VedantAndhale/claude-pro-kit
answer-pane
VedantAndhale/claude-pro-kit
Explanations as visual pages in a pane beside the chat: diagrams drawn in place, the full page one click away. No model calls.
cache-clock
VedantAndhale/claude-pro-kit
Shows how long the prompt cache stays warm, and when it expires, exactly how many tokens your next message will re-send uncached. No tokens spent.
collision-guard
VedantAndhale/claude-pro-kit
Asks before Claude edits a file another chat on this machine changed in the last 30 minutes. Each chat keeps its own small ledger; no model calls, no network.
context-xray
VedantAndhale/claude-pro-kit
A pane with the exact breakdown of what fills Claude's context: system prompt, tools, memory files, skills, messages, and which tools load on every request.
kit-updates
VedantAndhale/claude-pro-kit
Tells you when a newer version of an installed claude-pro-kit mod is out, and /kit-update installs it. One small download per session, no tokens spent.
output-diet
VedantAndhale/claude-pro-kit
Trims long shell output before Claude reads it: keeps the head, the tail and every error line, saves the full output to a file Claude can open.
pro-hud
VedantAndhale/claude-pro-kit
Desktop heads-up display for the Pro plan: exact 5h/7d usage gauges, context gauge, turn receipts, usage in the spinner and compact tool cards. No estimates, no tokens spent.
read-cap
VedantAndhale/claude-pro-kit
Stops Claude reading a file over 1,000 lines whole and gives it an outline tool (definitions with line numbers) so it reads only the range it needs. A retry still reads it whole.
reread-guard
VedantAndhale/claude-pro-kit
Stops Claude re-reading a file it already read in this conversation when the file has not changed since; a deliberate second attempt still goes through.
session-receipt
VedantAndhale/claude-pro-kit
/receipt opens a pane with the exact tokens every turn of the session spent (uncached, cached, output, subagents) and the costliest turns. No tokens spent.
tool-diet
VedantAndhale/claude-pro-kit
Moves tools you have not used lately behind ToolSearch, so their descriptions stop riding along on every request; core tools and anything you used in your last five sessions stay loaded.
turn-budget
VedantAndhale/claude-pro-kit
Asks before a single turn uses more than +5 session points or 500,000 uncached input tokens, and stops it cleanly if you say so. Checks between requests, never mid-command.