session-recovery

Diagnose Claude Code session persistence problems and recover missing session data.

62|10|Updated Dec 4, 2025
One-click install
npx skills add https://github.com/terrylica/cc-skills --skill session-recovery
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: session-recovery
Source: https://github.com/terrylica/cc-skills/tree/main/plugins/devops-tools/skills/session-recovery
Command: npx skills add https://github.com/terrylica/cc-skills --skill session-recovery

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Troubleshoots Claude Code session issues and recovers missing or corrupted session data.

Core Features & Use Cases

  • Diagnoses common HOME/session storage misconfigurations
  • Provides practical recovery steps and validation checks
  • Helps migrate legacy sessions to standard storage

Quick Start

Diagnose and recover missing sessions using the provided scripts

Frequently Asked Questions about session-recovery

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I recover missing Claude Code sessions?▼

Session recovery diagnoses why Claude Code shows 'No conversations found to resume' by checking HOME variable accuracy and ~/.claude/projects/ storage location. The Skill provides diagnostic steps and recovery scripts to restore missing or corrupted session data and validate persistence across environments.

Why aren't my Claude Code conversations resuming?▼

Conversations fail to resume when session files are misconfigured, missing, or stored in the wrong location. This Skill identifies HOME/storage misconfigurations, checks for legacy session migrations, and applies validation commands to restore access to your conversation history.

How do I fix Claude Code session storage problems?▼

Session storage problems stem from incorrect HOME variables or sessions stored outside ~/.claude/projects/. This Skill provides diagnostic checks, migration steps for legacy sessions, and verification commands to ensure sessions persist correctly across Claude Code invocations.

Can I migrate Claude Code sessions to a new environment?▼

Yes. This Skill handles legacy session migrations across environments by verifying HOME variable accuracy, confirming proper storage under ~/.claude/projects/, and providing recovery scripts to validate session data after migration.

What should I check if Claude Code session recovery fails?▼

If recovery fails, verify HOME variable is set correctly, confirm ~/.claude/projects/ exists and contains session files, and run the provided diagnostic commands. The Skill identifies whether files are missing, misplaced, or corrupted to guide the next recovery step.