rate-limit-management

Prevent Claude API failures by enforcing a three-tier wind-down protocol that suspends or throttles agent behavior when Claude Max usage reaches 85% and 95% thresholds, ensuring long-running operations pause safely without crashing.

The three-tier wind-down protocol manages agent throttling by applying Wind-Down behavior at 85% utilization, Minimal behavior between 85-95%, and Dark behavior above 95%, progressively reducing load while preserving responsiveness and automatically resuming below 20%.

Monitor Claude API utilization and send proactive Telegram alerts by executing the deterministic check-usage-api command with custom warning thresholds for 7-day and 5-hour rolling windows, configured directly to your Telegram chat ID.

Handle cron job suspension during high API utilization by applying automatic response and cron suspension rules when rolling 5-hour and 7-day usage thresholds are exceeded, restoring suspended work only after utilization drops below 20%.

This rate limiting approach works specifically for scheduled, proactive, and long-running multi-agent operations, applying cached usage retrieval and throttling rules to safely pause work based on rolling 5-hour and 7-day Claude Max usage metrics.

Long-running proactive agents crash when Claude Max usage thresholds are breached, triggering hard API failures; recovery occurs automatically when utilization drops below 20%, restoring suspended cron work and notifying the user.