ruben-sj/respawn-skill

> Fixes "Rate limit exceeded" overnight cutoffs in Claude Code by auto-resuming the session once the 5-hour usage window reopens.
A community-made Claude Code skill that auto-resumes a session after it gets blocked by Claude's usage limit. It waits for the window to reopen, notifies you, and continues the interrupted work unless you cancel within a configurable grace window.
Field-tested (v0.2 core): multiple overnight runs, multiple sessions running it in parallel, multiple consecutive 5-hour windows in a single run. The core mechanism (a scheduled job surviving repeated rate-limit rejections and firing correctly once the window reopens) has held up in real use. The v0.3 additions (live usage readings, backstop, soft stop) and the v0.4 additions (plugin, usage hook) are newer and less field-tested. Not an official Anthropic feature: auto-resume after a rate limit was requested in GitHub issues anthropics/claude-code #26775 and #36320, and Claude Code v2.1.234 and later has a built-in autoContinueAtUsageLimit setting (see below). This skill is a best-effort workaround built on scheduling tools (CronCreate/CronDelete/PushNotification) available in the harness, and may stop working if those tools change behavior. See Known limitations.
## Installation
macOS / Linux / Git Bash:
bash
mkdir -p ~/.claude/skills/respawn && curl -fsSL https://raw.githubusercontent.com/ruben-sj/respawn-skill/main/skill/SKILL.md -o ~/.claude/skills/respawn/SKILL.md
Windows PowerShell:
powershell
New-Item -ItemType Directory -Force "$HOME\.claude\skills\respawn" | Out-Null
Invoke-WebRequest https://raw.githubusercontent.com/ruben-sj/respawn-skill/main/skill/SKILL.md -OutFile "$HOME\.claude\skills\respawn\SKILL.md"
Or manually: copy the contents of skill/SKILL.md into ~/.claude/skills/respawn/SKILL.md (create the respawn folder if it doesn't exist).
Updating: rerun the install line; it overwrites the file with the latest version.
Pinning a version: to stay on a specific release, use a tag URL instead of main:
bash
mkdir -p ~/.claude/skills/respawn && curl -fsSL https://raw.githubusercontent.com/ruben-sj/respawn-skill/v0.4.1/skill/SKILL.md -o ~/.claude/skills/respawn/SKILL.md
As a plugin (v0.4, optional): the repo is also a Claude Code plugin and marketplace. This installs the same skill plus the optional usage hook (see below). The plugin's hook runs node after every tool call, so the plugin needs Node.js on your PATH; without it, Claude Code reports a hook error after tool calls. If you do not have Node.js, use the plain skill install above instead:
/plugin marketplace add ruben-sj/respawn-skill
/plugin install respawn@respawn-skill
From a shell, recent Claude Code builds also offer a one-step form: claude plugin install respawn --marketplace ruben-sj/respawn-skill (check claude plugin install --help for the --marketplace option).
If you installed the skill by hand earlier, delete ~/.claude/skills/respawn first so the skill is not defined twice. The curl install above keeps working: the skill stays at skill/SKILL.md, and the plugin points at that same file.
Requires CronCreate, CronDelete, and PushNotification tools in your harness. If your Claude Code environment doesn't expose these, the skill is inert.