Claude-File-Recovery, recover files from your ~/.claude sessions

Scans the ~/.claude directory structure to locate and parse serialized conversation session files, extracting embedded file artifacts that were generated or uploaded during Claude interactions. Uses filesystem traversal to identify session metadata and deserializes session state to recover file references and content payloads that may have been lost or deleted from the user's working directory.

Recursively walks the ~/.claude directory tree to build an index of all session files, extracting metadata like creation timestamps, conversation IDs, and file references without loading entire session payloads into memory. Uses efficient filesystem scanning to catalog available sessions and their contents, enabling users to selectively recover files from specific conversations rather than bulk extraction.

Enables users to filter recovered files by type (code, documents, images), date range, or session ID before extraction, preventing bulk recovery of unwanted files and allowing targeted restoration of specific artifacts. Implements filtering logic at the extraction stage to avoid unnecessary deserialization and disk writes of irrelevant files.

Detects duplicate files across multiple sessions (using content hashing or filename matching) and handles naming conflicts when recovering multiple versions of the same file. Implements strategies like timestamp-based versioning or content-based deduplication to prevent overwriting files and preserve all recovered versions with clear naming.

Exports recovered files to a user-specified output directory with configurable directory structure (flat, by session, by file type, or by date). Handles file permissions, creates necessary subdirectories, and provides progress reporting during batch recovery operations to manage large-scale artifact restoration.