agent-rate-limiter
por theagentwire
CLI UtilitiesResumen
Prevent 429s with automatic tier-based throttling & exponential backoff.
Descripción
Qué hace esta 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.
Cuándo 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
Flujo de trabajo de ejemplo
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
Instalación
clawhub install theagentwire/agent-rate-limiterEjecuta el comando de la CLI o pega el prompt en Claude Code, Cursor, Codex o el agente de programación que uses.