Where are Claude Code sessions stored?

Session files are stored locally on your machine in the ~/.claude/projects/ directory in JSONL format.

Does this work with binary files like images?

No, the recovery tool handles text-based code and paths. Binary files are typically not stored within the session logs themselves.

How do I find a session from a specific project?

You can use the provided list command with your project path to view all related session IDs, sizes, and timestamps for easier identification.

Can I recover files that weren't written to disk?

This skill primarily recovers content from 'Write' tool calls. While it can identify code in markdown blocks, it is most effective at restoring files that Claude actually attempted to save.

Claude Code History & Recovery

Name: Claude Code History & Recovery
Author: nguyendinhquocx

bynguyendinhquocx

개발자 도구

Recovers deleted files and extracts content from Claude Code session history logs.

소개

Claude Code History Files Finder is a specialized utility designed to browse, search, and restore data from Claude Code's local session history stored in ~/.claude/projects/. It enables developers to recover accidentally deleted code, track file evolution across multiple interactions, and analyze tool usage patterns using automated scripts for session listing, keyword searching, and content extraction. It is an essential tool for maintaining data integrity and finding past implementation details that may have been lost during active development sessions.

주요 기능

Extract file modifications and track Write, Edit, and Read operations
Search session history for specific keywords, functions, or error messages
0 GitHub stars
Generate detailed session statistics including message and tool counts
List and filter project sessions by timestamp and size
Recover deleted or lost source code from JSONL session files

사용 사례

Restoring a file that was accidentally overwritten or deleted during a Claude session
Finding a specific logic implementation discussed in a conversation from several sessions ago
Auditing AI tool usage and file operations for project history tracking

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add nguyendinhquocx/code-ai claude-code-history-files-finder

For use in Claude.ai and ChatGPT

Download Skill

GitHub

소개