agent-rate-limiter
di theagentwire
CLI UtilitiesSintesi
Prevent 429s with automatic tier-based throttling & exponential backoff.
Descrizione
Cosa fa questa skill
Tracks API request usage in a rolling window and assigns tiers (ok → cautious → throttled → critical → paused). Agents check their current tier before expensive operations and reduce activity accordingly. On a real 429 error, exponential backoff is calculated and recovery is scheduled automatically.
Unlike retry loops or monitoring dashboards, it prevents 429s before they happen by progressively downshifting agent activity, preserving context and avoiding wasted token spend.
Quando usarla
- Preventing 429 errors in long-running autonomous agent loops
- Throttling sub-agent spawning when approaching Claude Max limits
- Managing rate limits across multiple concurrent agent instances
- Keeping background cron jobs from burning through rolling windows
- Auto-recovering agent workflows after hitting a rate limit wall
Esempio di workflow
User asks: Run a multi-step research task using sub-agents
- 1
Runs
python3 scripts/rate-limiter.py gatebefore starting work - 2
Reads exit code: 0 means proceed normally, 1 means reduce activity, 2 means stop non-essential work
- 3
Spawns sub-agents and completes the research task
- 4
Records token usage with
python3 scripts/rate-limiter.py record 2000 - 5
On 429 error, runs
python3 scripts/rate-limiter.py pauseand waits for auto-resume
Research completes without rate limit interruptions; state file updated with rolling usage data
Installazione
clawhub install theagentwire/agent-rate-limiterEsegui il comando CLI oppure incolla il prompt in Claude Code, Cursor, Codex o nell'agente di coding che usi.