skills.rest
lucasgrow
lucasgrowCOMMUNITY
Explore all skills by this author →
GitHub

claude-code-history-files-finder

Recover and analyze Claude Code session history files from ~/.claude/projects.

3|Updated Feb 21, 2026
Search Tags:#claude code#code history#recovery#session history#file tracking#deleted files
One-click install
npx skills add https://github.com/lucasgrow/some-skills --skill claude-code-history-files-finder-lucasgrow
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: claude-code-history-files-finder
Source: https://github.com/lucasgrow/some-skills/tree/main/claude-code-history-files-finder
Command: npx skills add https://github.com/lucasgrow/some-skills --skill claude-code-history-files-finder-lucasgrow

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps you find and recover lost or deleted code and content from your Claude Code session history files, ensuring no work is permanently lost.

Core Features & Use Cases

  • Recover Deleted Files: Extract files that were written using the 'Write' tool in past sessions.
  • Search History: Find specific code snippets or content across multiple sessions using keywords.
  • Analyze Changes: Track file modifications and understand how code evolved over time.
  • Use Case: You accidentally deleted a crucial component file. Use this Skill to search your Claude session history for that file's name and recover its last saved version.

Quick Start

Use the claude-code-history-files-finder skill to recover content from the session file located at ~/.claude/projects/my-project/session-id.jsonl.

Frequently Asked Questions about claude-code-history-files-finder

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

FAQPage Schema
How do I recover deleted files from Claude Code session history?▼

You can recover deleted files from Claude Code session history by searching the JSONL files in ~/.claude/projects/ to extract content written via the 'Write' tool. This process reconstructs lost code by analyzing past session records.

Can I search for specific code snippets across multiple Claude Code sessions?▼

Yes, you can search for specific code snippets across multiple Claude Code sessions by scanning the JSONL history files in ~/.claude/projects/ using keywords. This allows you to locate exact content fragments recorded during previous interactions.

How does analyzing 'Edit' operations help reconstruct code history?▼

Analyzing 'Edit' operations helps reconstruct code history by tracking file modifications recorded in the JSONL session files. By examining these changes in ~/.claude/projects/, you can trace how specific code evolved through chronological edits.

Do I need Python installed to parse Claude Code history files?▼

Yes, you need Python 3.7 or higher installed to parse Claude Code history files. The scripts require Python to read and analyze the JSONL session data stored in your ~/.claude/projects/ directory for file extraction and keyword searching.

What is the best way to track file modifications in Claude Code?▼

The best way to track file modifications in Claude Code is by analyzing the 'Edit' and 'Write' tool operations logged in your session history. This approach monitors code evolution and extracts specific file versions from the JSONL records in ~/.claude/projects/.

Why are my Claude Code session files not showing recovered content?▼

Claude Code session files may not show recovered content if the files were not written using the 'Write' tool or if the JSONL files in ~/.claude/projects/ are inaccessible. Ensure you have direct directory access and the target sessions contain the required tool operations.

Related Skills

Explore More Software Engineering Skills→
kudrmaxkudrmax
1

search-conversations

Search past Claude Code sessions across projects using keyword queries.

Community
Intermediate
sayali-ingle-pdlsayali-ingle-pdl

gitignore

Generates a .gitignore file excluding common files and directories from version control.

Community
Basic
shdaifatshdaifat

Design Versioning Skill

Track and manage CAD design iterations using Git version control principles.

Community
Intermediate
zakariafzakariaf

ui-backup-card

Manage local backup export, import, encryption, and erase for Hifz Companion.

Community
Intermediate