{"passport":{"unfragile":{"@version":"1.0","version":"2026-05","artifact":{"id":"hn-47182387","slug":"claude-file-recovery-recover-files-from-your-claud","name":"Claude-File-Recovery, recover files from your ~/.claude sessions","type":"cli","url":"https://github.com/hjtenklooster/claude-file-recovery","page_url":"https://unfragile.ai/claude-file-recovery-recover-files-from-your-claud","categories":["cli-tools"],"tags":["hackernews","show-hn"],"pricing":{"model":"open_source","free":true,"starting_price":null},"status":"active","verified":false},"capabilities":[{"id":"hn-47182387__cap_0","uri":"capability://data.processing.analysis.claude.session.file.extraction.and.parsing","name":"claude session file extraction and parsing","description":"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.","intents":["Recover code files or documents I generated in Claude conversations but didn't save locally","Extract files from old Claude sessions after clearing my chat history","Batch retrieve all files I've worked on across multiple Claude conversations"],"best_for":["Developers who use Claude for code generation and lose track of generated files","Users who clear Claude chat history but need to recover artifacts","Teams managing Claude-generated assets across multiple sessions"],"limitations":["Only recovers files from local ~/.claude cache — no recovery from cloud-deleted sessions","Depends on Claude's session serialization format remaining stable — breaking changes in Claude's storage format would break recovery","Cannot recover files if the ~/.claude directory itself has been deleted or corrupted","Limited to files that were explicitly attached or generated as artifacts in Claude — inline code snippets may not be recoverable"],"requires":["Local access to ~/.claude directory with read permissions","Claude CLI or web client that stores sessions locally","Python 3.7+ or Node.js 14+ (depending on implementation language)"],"input_types":["filesystem paths","session directory structure"],"output_types":["recovered files (code, documents, images, etc.)","structured session metadata","file manifest with timestamps and types"],"categories":["data-processing-analysis","file-recovery"],"confidence":0.5,"matches":0,"success_rate":0},{"id":"hn-47182387__cap_1","uri":"capability://data.processing.analysis.session.directory.traversal.and.indexing","name":"session directory traversal and indexing","description":"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.","intents":["List all my Claude sessions and see what files are available in each","Find which session contains a specific file I'm looking for","Get a timeline view of files I've generated across conversations"],"best_for":["Users with large numbers of Claude sessions who need to search for specific artifacts","Developers building tools on top of Claude session data","Users auditing what files they've generated in Claude"],"limitations":["Indexing performance degrades with very large session directories (10,000+ sessions may require several seconds)","Metadata extraction depends on consistent session file naming and structure — custom Claude configurations may break indexing","Does not index file content, only metadata — cannot search for files by content keywords"],"requires":["Read access to ~/.claude directory and all subdirectories","Sufficient disk I/O performance for filesystem traversal"],"input_types":["filesystem paths"],"output_types":["structured index (JSON or CSV)","session list with metadata","file manifest with paths and types"],"categories":["data-processing-analysis","search-retrieval"],"confidence":0.5,"matches":0,"success_rate":0},{"id":"hn-47182387__cap_2","uri":"capability://data.processing.analysis.selective.file.recovery.with.filtering","name":"selective file recovery with filtering","description":"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.","intents":["Recover only Python files from my Claude sessions, not all artifacts","Extract files generated in the last 7 days across all conversations","Get all files from a specific conversation without recovering everything"],"best_for":["Users with selective recovery needs who don't want to restore entire session histories","Developers integrating file recovery into larger workflows with specific file type requirements","Users with storage constraints who need to be selective about what they recover"],"limitations":["File type detection relies on file extensions or MIME type metadata — files without proper extensions may be misclassified","Date filtering depends on accurate timestamps in session metadata — clock skew or timezone issues could cause incorrect filtering","Complex filter combinations (e.g., 'Python files from sessions containing React code') are not supported"],"requires":["Session metadata with file type and timestamp information","Filter syntax understanding (regex, date formats, file extensions)"],"input_types":["filter criteria (file type, date range, session ID)"],"output_types":["filtered file list","recovered files matching criteria"],"categories":["data-processing-analysis"],"confidence":0.5,"matches":0,"success_rate":0},{"id":"hn-47182387__cap_3","uri":"capability://data.processing.analysis.file.deduplication.and.conflict.resolution","name":"file deduplication and conflict resolution","description":"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.","intents":["Recover the same file from multiple sessions without losing any version","Avoid overwriting existing files when recovering artifacts with the same name","Identify which version of a file is the most recent or most complete"],"best_for":["Users who have iterated on the same file across multiple Claude conversations","Developers managing multiple versions of generated code or documents","Teams using Claude for collaborative work where the same file may be recovered multiple times"],"limitations":["Content-based deduplication requires hashing all recovered files, adding computational overhead","Conflict resolution strategies are heuristic-based — users may still need to manually choose between versions","No built-in diff or merge tool to compare file versions — users must manually review duplicates"],"requires":["Hashing algorithm (MD5, SHA-256) for content comparison","Output directory with write permissions"],"input_types":["recovered file list"],"output_types":["deduplicated file list","versioned files with conflict markers","deduplication report"],"categories":["data-processing-analysis"],"confidence":0.5,"matches":0,"success_rate":0},{"id":"hn-47182387__cap_4","uri":"capability://automation.workflow.batch.recovery.to.specified.output.directory","name":"batch recovery to specified output directory","description":"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.","intents":["Export all recovered files to a specific folder on my computer","Organize recovered files by session or file type in the output directory","Monitor progress while recovering hundreds of files from multiple sessions"],"best_for":["Users recovering large numbers of files who need organized output","Developers integrating file recovery into backup or archival workflows","Users with specific directory structure requirements for recovered files"],"limitations":["Output directory structure is static — cannot reorganize files after recovery without re-running the tool","Large batch recoveries may consume significant disk space and I/O bandwidth","No built-in compression or archival format — recovered files are written individually to disk","Progress reporting is approximate and may not account for variable file sizes or I/O latency"],"requires":["Write access to output directory","Sufficient free disk space for all recovered files","Proper file permissions to create subdirectories"],"input_types":["output directory path","directory structure template"],"output_types":["recovered files in output directory","progress log","recovery summary report"],"categories":["automation-workflow"],"confidence":0.5,"matches":0,"success_rate":0}],"trust":{"score":38,"verified":false,"data_access_risk":"high","permissions":["Local access to ~/.claude directory with read permissions","Claude CLI or web client that stores sessions locally","Python 3.7+ or Node.js 14+ (depending on implementation language)","Read access to ~/.claude directory and all subdirectories","Sufficient disk I/O performance for filesystem traversal","Session metadata with file type and timestamp information","Filter syntax understanding (regex, date formats, file extensions)","Hashing algorithm (MD5, SHA-256) for content comparison","Output directory with write permissions","Write access to output directory"],"failure_modes":["Only recovers files from local ~/.claude cache — no recovery from cloud-deleted sessions","Depends on Claude's session serialization format remaining stable — breaking changes in Claude's storage format would break recovery","Cannot recover files if the ~/.claude directory itself has been deleted or corrupted","Limited to files that were explicitly attached or generated as artifacts in Claude — inline code snippets may not be recoverable","Indexing performance degrades with very large session directories (10,000+ sessions may require several seconds)","Metadata extraction depends on consistent session file naming and structure — custom Claude configurations may break indexing","Does not index file content, only metadata — cannot search for files by content keywords","File type detection relies on file extensions or MIME type metadata — files without proper extensions may be misclassified","Date filtering depends on accurate timestamps in session metadata — clock skew or timezone issues could cause incorrect filtering","Complex filter combinations (e.g., 'Python files from sessions containing React code') are not supported","builder identity is not verified yet","no observed match outcomes yet"],"rank_breakdown":{"adoption":0.58,"quality":0.2,"ecosystem":0.46,"match_graph":0.25,"freshness":0.6,"weights":{"adoption":0.25,"quality":0.25,"ecosystem":0.1,"match_graph":0.28,"freshness":0.12}},"observed_outcomes":{"matches":0,"success_rate":0,"avg_confidence":0,"top_intents":[],"last_matched_at":null},"maintenance":{"status":"active","updated_at":"2026-06-17T09:51:04.692Z","last_scraped_at":"2026-05-04T08:10:06.239Z","last_commit":null},"community":{"stars":null,"forks":null,"weekly_downloads":null,"model_downloads":null,"model_likes":null}},"distribution":{"claim_url":"https://unfragile.ai/submit?claim=claude-file-recovery-recover-files-from-your-claud","compare_url":"https://unfragile.ai/compare?artifact=claude-file-recovery-recover-files-from-your-claud"}},"signature":"u/iQNN9j8Dzcozlto5NdL3eCxDYiYgqfHuGb0k1o1vh7y7Z3CiqvnrAWkke+jlXN3SAAcKc724YBu3OA9tGzDQ==","signedAt":"2026-06-20T07:02:02.338Z","signedBy":"unfragile.ai","version":1},"_links":{"self":"https://unfragile.ai/api/v1/passport/claude-file-recovery-recover-files-from-your-claud","artifact":"https://unfragile.ai/claude-file-recovery-recover-files-from-your-claud","verify":"https://unfragile.ai/api/v1/verify?slug=claude-file-recovery-recover-files-from-your-claud","publicKey":"https://unfragile.ai/api/v1/trust-passport-public-key","spec":"https://unfragile.ai/trust","schema":"https://unfragile.ai/schema.json","docs":"https://unfragile.ai/docs"}}