ΙWhat it is
Agents do not know what they cost. They will happily start a deep refactor with five percent of a session budget left, lose the thread halfway, and leave the work worse than they found it. budget-guard closes that loop.
With the plugin installed, the agent:
- Reads current session spend and remaining budget before planning work.
- Sizes its plan to what is left: small budget, small steps.
- Warns before starting anything it may not be able to finish.
- Wraps up cleanly near the limit instead of stopping mid-edit.
ΙΙInstall
One line, from the plugin marketplace:
$
claude plugin add 40second/budget-guard
No configuration required. Budgets are read from the session; thresholds can be tuned in .claude/budget-guard.json if the defaults do not fit.