CC Session Recover

cc-session-recover

Claude Code stopped at 1 AM. The quota reset passed. Your terminal still waited
for one word:

cc-session-recover gives Claude Code a recovery plan before you walk away. It
installs a StopFailure hook, a /session-recover command, a HANDOFF.md
notebook, and an optional watcher. When Claude Code hits a rate limit or
overload, the hook records the failure. After the retry window passes, the armed
session reads the handoff and continues the task.

No tmux tricks. No hidden prompt injection. No OS hacks.

The demo shows Claude Code hitting a real quota stop on June 12, waiting through
the reset, and continuing the same task.

Install

Install into your Claude Code project:

Install from a clone of this repo:

Claude Code asks you to approve the hook command the next time you open that
project. The installer keeps an existing HANDOFF.md or
session-recover.yaml.

Pass --no-hooks if you want to copy the files without merging hook settings
into .claude/settings.local.json.

Use It

Start Claude Code in the project:

Give Claude Code the task, then arm recovery:

Use a custom check interval when you want one:

The default interval is 30 minutes. Claude Code creates one recurring in-session
schedule with this prompt:

Keep that Claude Code session open. The schedule checks the task while the
session sits idle, then continues, waits, or stops.

Claude Is Back

Someone else says "Claude is down." You keep your lunch, meeting, or overnight
run intact because the project already has three pieces of recovery state:

- HANDOFF.md tells Claude Code what changed and what to do next.
- .claude/quota-blocked.json records the transient failure and retry window.
- The recovery schedule checks the marker and resumes from the handoff after
  the window opens.

The installed…