cc-session-recover recovers Claude Code sessions after quota stops

The GitHub repository softcane/cc-session-recover provides scripts and hooks designed to preserve and resume interrupted Claude Code sessions after quota or rate-limit stops, per the project's README on GitHub. The repository reports that the assistant writes a recovery note called HANDOFF.md while working, that the system retries on a slow schedule while quota is blocked, and that the first attempt after a reset picks the task up where it left off. The README describes two recovery modes: a heartbeat that keeps the active session alive when the terminal remains open, and a closed-terminal watcher that targets the recorded session ID. The README explicitly states the tool does not bypass quota limits and that the worst case is manual continuation using the HANDOFF.md file.

The project README notes avoidance of terminal-injection hacks such as tmux or screen and instead uses headless claude -p --resume for the optional closed-terminal watcher. Install instructions include an npx cc-session-recover init /path/to/project flow and a script-based alternative. Users must approve hooks when Claude Code requests them on first start.

For developers running long-running coding or data-processing sessions against rate-limited LLM endpoints, session loss creates wasted developer time and context-rebuilding effort. Tools that standardize a repository-level handoff note and an automated retry policy can reduce manual recovery work and improve reproducibility of interrupted runs. Projects like this reflect a broader ecosystem of community tooling focused on resilient CLI access patterns for Claude Code.

Adoption indicators include forks, stars, and issue activity on the repo, usage examples demonstrating closed-terminal resume across cloud quota windows, and compatibility reports with new Claude Code client releases. Watch for security and credential-handling discussion in issues if the watcher requires stored session tokens.