claude-code-history-files-finder

Recover deleted content by parsing Claude Code session history files stored in ~/.claude/projects/. The Skill extracts Write tool calls from JSONL session logs, reconstructs deleted file versions, and generates recovery reports showing what was written and when.

Yes, search sessions for keywords within ~/.claude/projects/ using keyword filtering on streamed JSONL session data. The Skill scans conversation history and file operations across all sessions in a project and returns matching results with deduplication.

List sessions and analyze statistics using the analyze_sessions.py script. It parses session JSONL files to display session metadata, file operations, and conversation data, supporting both listing and keyword-filtered search across project history.

Claude Code stores session history as JSONL (JSON Lines) files in ~/.claude/projects/. Each line is a JSON object representing a tool call or event, enabling streaming parsing and efficient recovery of individual operations without loading entire sessions into memory.

Track file changes by analyzing Write tool calls across sessions. The Skill deduplicates writes and generates analytics showing file operation history, allowing you to understand what changed, when, and across which sessions within a project.

No external dependencies are required. The Skill uses Python 3 with standard libraries to parse JSONL files from ~/.claude/projects/, making it portable and requiring only access to your local Claude Code project directory.