Claude Usage Guard — Development skill for Claude Code
Pause Claude before its next tool call when your 5-hour or weekly plan usage runs hot with lots of window left, and resume when you reply.
How to install Claude Usage Guard
This entry records only its repository, not the path inside it, so there is no
exact command to give. Open Clumsynite/claude-usage-guard and copy the folder into
~/.claude/skills/, or the file into ~/.claude/agents/.
What Claude Usage Guard does
Pause Claude before its next tool call when your 5-hour or weekly plan usage runs hot with lots of window left, and resume when you reply. Hooks only, zero tokens until it fires; needs a short status line snippet to see usage.
Alternatives in Development
- Manage Managed Silo Lifecycle — Apply start / pause / delete lifecycle transitions to a managed E2B or Daytona cloud silo with farm silo , for 67 ★
- Brow — Claude Code usage and rate limits in the MacBook notch 50 ★
- Ox Session Pause — <!-- Keep this file thin 50 ★
README
usage-guard
[](https://github.com/Clumsynite/claude-usage-guard/actions/workflows/ci.yml) [](https://github.com/Clumsynite/claude-usage-guard/actions/workflows/release.yml) [](https://github.com/Clumsynite/claude-usage-guard/releases/latest) [](LICENSE)
A Claude Code plugin that pauses Claude before its next tool call when your plan usage is running hot: by default, when the 5-hour window is **80% used with at least an hour still to go**, or the weekly window is **90% used with at least a day to go**. You see why it stopped, and Claude continues when you reply.
Why
Claude can't see your plan usage. Only the status line gets it, so a long autonomous run can burn through a 5-hour window in the first hour and leave you locked out for the next four. usage-guard reads the numbers your status line already receives and stops Claude once per window, while you still have room to decide: carry on, switch to something cheaper, or stop for now.
It fires when you're burning **fast**, meaning high usage with plenty of window left. Near the end of a window it stays quiet, because hitting the cap then costs you little.
Token cost
Zero on the normal path. usage-guard is hooks only: no skills, no MCP server, nothing added to Claude's context. When usage is below the thresholds, the hook exits silently. When it fires, the pause message (about 60 tokens) is shown once and stays in the conversation.
Install
From GitHub:
/plugin marketplace add Clumsynite/claude-usage-guard
/plugin install usage-guard@clumsyknight-usage-guardFrom a local clone:
claude plugin marketplace add /path/to/claude-usagRelated Skills
Claude Statusline Plus
Claude Code status line segments: whether your prompt cache is still warm and what a cold start costs, and whe
Clear On
Turn on Clear Answer mode. Every following reply is written in short, plain English and gated by the linter un
Kairos
Show what is left of the five-hour usage window, and manage the gate
Cancel Weekly Reports
Cancel or Pause a Scheduled Weekly Report
Pantheon Andon Cord
Invoke the Andon Cord Protocol — pause all work, identify root cause, do not resume until blocker is resolved
Clockoff
End the working day - save open work, write tomorrow's list, pause agents until morning
Related Agents
Interview Conductor
Conducts adaptive voice elicitation interviews. Presents questions conversationally across 12 thematic modules
Half Fix
Review angle "half-fix & consistency" of the user's §6 adversarial-review gate — hunts the sins tests cannot s
Distill Critic
Adversarial checker for the distill skill. Given a reply's substance, its distilled version, and the proposed
