Automatically pauses Claude Code when usage exceeds 90% to avoid hitting rate limits
npx claudepluginhub willyt3hwhale/cc-limit-guard --plugin rate-limit-guardA Claude Code plugin that monitors your usage and automatically pauses when approaching rate limits.
| Limit | Threshold | Reset Period |
|---|---|---|
| Session | 90% | Every 5 hours |
| Weekly | 95% | Every 7 days |
In Claude Code, run:
/plugin marketplace add willyt3hwhale/cc-limit-guard
/plugin add rate-limit-guard@cc-limit-guard
git clone https://github.com/willyt3hwhale/cc-limit-guard ~/.claude/plugins/local/cc-limit-guard
Then add an alias to your shell config:
alias claude='claude --plugin-dir ~/.claude/plugins/local/cc-limit-guard'
No manual configuration needed. The plugin automatically finds your credentials in this order:
ANTHROPIC_API_KEY environment variable~/.claude/.credentials.json (written by Claude Code on login)Claude Code-credentials)Just install the plugin and it works.
The plugin runs automatically. You'll see usage info as a system message:
Session: 29% | Weekly: 12%
When either threshold is exceeded, the plugin will:
To temporarily bypass the rate limit guard:
CLAUDE_NO_LIMIT=1 claude
jq installed (brew install jq / apt install jq)The plugin uses a PreToolUse hook that runs before each tool call. It:
api.anthropic.com and reads rate limit headers backMIT
Ultra-compressed communication mode. Cuts ~75% of tokens while keeping full technical accuracy by speaking like a caveman.
Matches all tools
Hooks run on every tool call, not just specific ones
Intelligent prompt optimization using skill-based architecture. Enriches vague prompts with research-based clarifying questions before Claude Code executes them
Persistent memory system for Claude Code - seamlessly preserve context across sessions