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

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.

Unique: Directly targets Claude's local session storage format to recover artifacts that exist nowhere else — most recovery tools focus on cloud backups or trash bins, but this exploits the fact that Claude caches full conversation state locally including all generated files

vs alternatives: Recovers Claude-specific artifacts that generic file recovery tools cannot access because they're embedded in proprietary session serialization rather than stored as independent files

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.

Unique: Builds a queryable index of Claude sessions without requiring full deserialization of each session file, using lazy-loading patterns to minimize memory footprint and enable fast searches across hundreds of conversations

vs alternatives: More efficient than generic file indexing tools because it understands Claude's session structure and can extract conversation-level metadata without parsing full file contents

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.

Unique: Implements multi-dimensional filtering (type, date, session) at the extraction layer rather than post-hoc filtering, reducing I/O overhead and enabling users to avoid recovering files they don't need

vs alternatives: More granular than simple bulk recovery tools — allows users to recover specific subsets of artifacts without touching the entire session cache

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.

Unique: Implements intelligent deduplication at recovery time rather than requiring manual cleanup afterward, using content hashing to identify true duplicates vs. files with the same name but different content

vs alternatives: Prevents data loss from overwriting files during recovery — generic file recovery tools often blindly overwrite or fail on conflicts, while this tool preserves all 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.

Unique: Provides multiple output organization strategies (flat, by session, by type, by date) rather than forcing a single directory structure, allowing users to choose the layout that best fits their workflow

vs alternatives: More flexible than tools that dump all recovered files into a single directory — enables users to maintain logical organization and easily locate specific files after recovery

google-gemini/gemini-cli | DeepWiki Loading... Index your code with Devin DeepWiki DeepWiki google-gemini/gemini-cli Index your code with Devin Edit Wiki Share Loading... Last indexed: 3 June 2026 ( d2cd12 ) Overview Architecture Overview Package Structure Getting Started Installation and Setup Authentication Basic Configuration User Guide Interactive Mode and Basic Usage Slash Commands At Commands and File References Built-in Tools Shell Mode and Command Execution Sandbox Environments MCP Server Integration Non-Interactive Mode Session Management IDE Integration Agent Skills and Sub-agents Core Systems Application Lifecycle and Initialization Configuration System Settings Management Gemini API Client Architecture Streaming and Turn Processing Tool System Architecture Tool Execution Pipeline UI State Management Input Handling and Text Buffer Command Processing System History and Message Display Chat Compression and Context Management System Prompt Generation Advanced Topics Extension System Extension Configuration and Variables MCP Server Management Telemetry and Observability Security and Approval System Model Configuration and Routing Hooks System A2A Server and Agent Protocol SDK and Programmatic API Browser Agent DevTools and Debugging Development Development Setup Build System and Bundling Testing Infrastructure Behavioral Evaluations (Evals) Perf

Architecture Overview | google-gemini/gemini-cli | DeepWiki Loading... Index your code with Devin DeepWiki DeepWiki google-gemini/gemini-cli Index your code with Devin Edit Wiki Share Loading... Last indexed: 3 June 2026 ( d2cd12 ) Overview Architecture Overview Package Structure Getting Started Installation and Setup Authentication Basic Configuration User Guide Interactive Mode and Basic Usage Slash Commands At Commands and File References Built-in Tools Shell Mode and Command Execution Sandbox Environments MCP Server Integration Non-Interactive Mode Session Management IDE Integration Agent Skills and Sub-agents Core Systems Application Lifecycle and Initialization Configuration System Settings Management Gemini API Client Architecture Streaming and Turn Processing Tool System Architecture Tool Execution Pipeline UI State Management Input Handling and Text Buffer Command Processing System History and Message Display Chat Compression and Context Management System Prompt Generation Advanced Topics Extension System Extension Configuration and Variables MCP Server Management Telemetry and Observability Security and Approval System Model Configuration and Routing Hooks System A2A Server and Agent Protocol SDK and Programmatic API Browser Agent DevTools and Debugging Development Development Setup Build System and Bundling Testing Infrastructure Behavioral Ev

Getting Started | google-gemini/gemini-cli | DeepWiki Loading... Index your code with Devin DeepWiki DeepWiki google-gemini/gemini-cli Index your code with Devin Edit Wiki Share Loading... Last indexed: 3 June 2026 ( d2cd12 ) Overview Architecture Overview Package Structure Getting Started Installation and Setup Authentication Basic Configuration User Guide Interactive Mode and Basic Usage Slash Commands At Commands and File References Built-in Tools Shell Mode and Command Execution Sandbox Environments MCP Server Integration Non-Interactive Mode Session Management IDE Integration Agent Skills and Sub-agents Core Systems Application Lifecycle and Initialization Configuration System Settings Management Gemini API Client Architecture Streaming and Turn Processing Tool System Architecture Tool Execution Pipeline UI State Management Input Handling and Text Buffer Command Processing System History and Message Display Chat Compression and Context Management System Prompt Generation Advanced Topics Extension System Extension Configuration and Variables MCP Server Management Telemetry and Observability Security and Approval System Model Configuration and Routing Hooks System A2A Server and Agent Protocol SDK and Programmatic API Browser Agent DevTools and Debugging Development Development Setup Build System and Bundling Testing Infrastructure Behavioral Evaluati

google-gemini/gemini-cli | DeepWiki Loading... Index your code with Devin DeepWiki DeepWiki google-gemini/gemini-cli Index your code with Devin Edit Wiki Share Loading... Last indexed: 3 June 2026 ( d2cd12 ) Overview Architecture Overview Package Structure Getting Started Installation and Setup Authentication Basic Configuration User Guide Interactive Mode and Basic Usage Slash Commands At Commands and File References Built-in Tools Shell Mode and Command Execution Sandbox Environments MCP Server Integration Non-Interactive Mode Session Management IDE Integration Agent Skills and Sub-agents Core Systems Application Lifecycle and Initialization Configuration System Settings Management Gemini API Client Architecture Streaming and Turn Processing Tool System Architecture Tool Execution Pipeline UI State Management Input Handling and Text Buffer Command Processing System History and Message Display Chat Compression and Context Management System Prompt Generation Advanced Topics Extension System Extension Configuration and Variables MCP Server Management Telemetry and Observability Secu