Skillget

cc-session-recover

skill
Security Audit
Fail
Health Pass
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Community trust — 11 GitHub stars
Code Fail
  • fs module — File system access in .github/workflows/publish.yml
  • child_process — Shell command execution capability in bin/cli.js
  • fs module — File system access in bin/cli.js
Permissions Pass
  • Permissions — No dangerous permissions requested

No AI report is available for this listing yet.

SUMMARY

AFK mode for Claude Code. Recover Claude Code sessions after quota or rate-limit stops.

README.md

cc-session-recover

AFK mode for Claude Code.

Start a long Claude Code task, walk away, sleep, hit quota, close the terminal,
come back later, the task still knows where it was and how to continue.

  • ✅ No quota bypass
  • ✅ No tmux injection
  • ✅ Exact-session resume
  • ✅ HANDOFF.md written to disk
  • ✅ Manual fallback: Read HANDOFF.md and continue

Claude Code continuing after a real quota stop

Real quota stop on June 12: scheduled attempts waited, then Claude continued after reset.

Install

npx cc-session-recover init /path/to/project

(Or from a clone: bash scripts/install-into-project.sh /path/to/project. Pass --no-hooks with either to install the files without activating anything.)

Approve the hooks once when Claude Code asks on the next start. That's the whole setup.

Use

cd /path/to/project
claude

Give Claude your task, normally. Nothing extra to type — the injected standing instructions make Claude keep the recovery note and set its own retry schedule. Leave the terminal open and walk away.

If quota dies mid-task, work resumes automatically after the reset.

Why This Approach Is Stronger

  • It avoids tmux, screen, and terminal-injection hacks. Headless claude -p --resume is used only by the optional closed-terminal watcher, targeting the exact recorded session.
  • It gives you two recovery paths. With the terminal open, the heartbeat resumes inside the active Claude Code session. With the terminal closed, the watcher resumes the saved session id.
  • HANDOFF.md keeps the next step in the repo, with project state, recent progress, and the exact next action.
  • The heartbeat runs inside the active Claude Code session, so the original context stays alive while quota is blocked.

Limits

  • It does not bypass quota. It only waits for the reset.
  • The basic flow needs the terminal to stay open. A closed-terminal recovery mode exists; see the docs.
  • Worst case is never lost work: the recovery note is always on disk, and "Read HANDOFF.md and continue" restores any session by hand.

Docs

  • Simple flow — how it works, told as a story (notebook, alarm, watchman).
  • FAQ — reliability, hook approval, what still needs a human.
  • Full details — closed-terminal watcher, precise reset-time resume, all limits.

Reviews (0)

No results found