claudeers.
// DevOps & CI/CD

cc-session-recover

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

// DevOps & CI/CD[ cli ][ api ][ claude ]#claude#claude-code#hooks#quota#rate-limit#resume#session-recovery#devops◷ MIT$open-sourceupdated about 2 months ago
Slowing down
94/100
last commit about 2 months ago
last release about 2 months ago
releases 7
open issues 1
// star history+7 this week (+13.2%)
★ 60 github ↗npm ↗

Install with your AI

Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.

Install and set up cc-session-recover (npm project) into my current project.
Found on https://claudeers.com/cc-session-recover
Repo: https://github.com/softcane/cc-session-recover
Homepage/docs: —
Detected install method: npm → npm install cc-session-recover
Category: devops. Platforms: cli, api.
Read the repo's README for exact setup and env vars, then install it and wire it into my project.

Claudeers Health Verdict:
slowing; community-verified: false. Confirm the source before running anything.
// or install directly (npm)
npm install cc-session-recover
// or clone
git clone https://github.com/softcane/cc-session-recover

// compatibility

Platformscli, api
Operating systems—
AI compatibilityclaude
LicenseMIT
Pricingopen-source
LanguageShell

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 tmux injection
  • ✅ Exact-session resume
  • ✅ HANDOFF.md written to disk
  • ✅ Resume: Read HANDOFF.md and continue

Claude Code continuing after a real quota stop

Example: My Claude Code quota stopped on June 12, scheduled attempts waited, then Claude continued after the reset. No babysitting

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.

// faq

What is cc-session-recover?

AFK mode for Claude Code. Recover Claude Code sessions after quota or rate-limit stops.. It is open-source on GitHub.

Is cc-session-recover free to use?

cc-session-recover is open-source under the MIT license, so it is free to use.

What category does cc-session-recover belong to?

cc-session-recover is listed under devops in the Claudeers registry of Claude-compatible tools.

1 views
★ 60 stars
unclaimed
updated about 2 months ago

// embed badge

cc-session-recover on Claudeers
[![Claudeers](https://claudeers.com/api/badge/cc-session-recover.svg)](https://claudeers.com/cc-session-recover)

// retro hit counter

cc-session-recover hit counter
[![Hits](https://claudeers.com/api/counter/cc-session-recover.svg)](https://claudeers.com/cc-session-recover)

// reviews

// guestbook

0/500

// related in DevOps & CI/CD

🔓
TrendRadar

⭐AI-driven public opinion & trend monitor with multi-platform aggregation, RSS, and smart alerts.🎯 告别信息过载，你的 AI 舆情监控助手与热点筛选工具！聚合多平台热点 + RSS 订阅，支持关键词精准筛选。AI…

// devopssansan0/⟨Python⟩★ 61,486◷ GPL-3.0[ claude ]
🔓
claude-code-router

Use Claude Code as the foundation for coding infrastructure, allowing you to decide how to interact with the model while enjoying updates from Anthropic.

// devopsmusistudio/⟨TypeScript⟩★ 36,683◷ MIT[ claude ]
🔓
Antigravity-Manager

Professional Antigravity Account Manager & Switcher. One-click seamless account switching for Antigravity Tools. Built with Tauri v2 + React (Rust).专业的 Antig…

// devopslbjlaq/⟨Rust⟩★ 30,371◷ NOASSERTION[ claude ]
→ see how cc-session-recover connects across the ecosystem