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.