agent-rate-limiter
由 theagentwire 提供
CLI Utilities简介
Prevent 429s with automatic tier-based throttling & exponential backoff.
描述
该技能的功能
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.
何时使用
- 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
示例工作流
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
安装
clawhub install theagentwire/agent-rate-limiter运行 CLI 命令,或把这段提示词粘贴到 Claude Code、Cursor、Codex 或你在用的任意编程智能体里。