sciccolella

Claude Ratelimit Mod — Development skill for Claude Code

Development community

A Claude Code mod that protects long multi-agent runs from the 5-hour usage limit.

How to install Claude Ratelimit Mod

This entry records only its repository, not the path inside it, so there is no exact command to give. Open sciccolella/claude-ratelimit-mod and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Claude Ratelimit Mod does

A Claude Code mod that protects long multi-agent runs from the 5-hour usage limit. When the window reaches a threshold (default 90%) it:

Alternatives in Development

  • Claude Swap — Switch between multiple Claude Code accounts, with automatic rate-limit rotation, usage dashboard, and paralle 2k ★
  • Memory Search — Search through Claude's persistent memories for specific content, patterns, or keywords 332 ★
  • Usage Limit Reducer — A Claude Code skill that stops you from burning through your usage limit 186 ★

README

rate-limit-guard

A Claude Code mod that protects long multi-agent runs from the 5-hour usage limit. When the window reaches a threshold (default 90%) it:

  1. tells every running subagent to stop at a safe point and write a checkpoint,
  2. tells the orchestrator to collect their replies, write its own checkpoint and stop,
  3. waits for the window to reset, then prompts the orchestrator to read the checkpoints and continue.

Only the `five_hour` window is watched, and only on a subscription (on API billing there are no rate-limit windows to read).

Install

/plugin install rate-limit-guard --marketplace sciccolella/claude-ratelimit-mod

Options

Option Default Meaning
threshold 90 Percent of the 5-hour window that triggers the stop
checkpointDir .claude/checkpoints Where checkpoints are written
autoResume true Prompt the orchestrator to continue after the reset
resumeBufferSeconds 60 Extra seconds to wait after the reset time
resumeMode continue continue keeps the full transcript, compact compacts the session, clear runs /clear before resuming. /rate-limit-guard-resume-mode overrides it for one session

Checkpoint files

  • Agents: /--.md, with the exact path given in each agent's stop message.
  • Orchestrator: /orchestrator-.md.
  • is the first 8 hex chars of the SHA-256 of the session id. The resume prompt only reads files with the current session's hash.

Commands

Each command also has a short name: `/rlg-status`, `/rlg-resume-mode`, `/rlg-rearm`.

  • /rate-limit-guard-status shows each rate-limit window the API reports (percentage and reset time), the guard state (armed or draining) and the resume mode in effect. In testing only the 5-hour window was reported; a weekly window did not appear, so the guard watches the 5-hour window only.
  • `/rate-limit-guard-resume-mode [clear|compa