Skip to content
TakoAPI
Back to skills

agent-rate-limiter

by theagentwire

CLI Utilities
670Downloads reported by clawskills.sh
2Stars
0Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

Prevent 429s with automatic tier-based throttling & exponential backoff.

Description

What This Skill Does

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.

When to Use It

  • 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

Example Workflow

INPUT

User asks: Run a multi-step research task using sub-agents

AGENT
  1. 1

    Runs python3 scripts/rate-limiter.py gate before starting work

  2. 2

    Reads exit code: 0 means proceed normally, 1 means reduce activity, 2 means stop non-essential work

  3. 3

    Spawns sub-agents and completes the research task

  4. 4

    Records token usage with python3 scripts/rate-limiter.py record 2000

  5. 5

    On 429 error, runs python3 scripts/rate-limiter.py pause and waits for auto-resume

OUTPUT

Research completes without rate limit interruptions; state file updated with rolling usage data

Installation

clawhub install theagentwire/agent-rate-limiter

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links