Theclaude — Development skill for Claude Code
A CLI tool that automatically scans Claude Code conversation logs to rescue deleted or lost files with smart filtering, previews, and safe recovery.
How to install Theclaude
This entry records only its repository, not the path inside it, so there is no
exact command to give. Open nickpending/theclaude and copy the folder into
~/.claude/skills/, or the file into ~/.claude/agents/.
What Theclaude does
A CLI tool that automatically scans Claude Code conversation logs to rescue deleted or lost files with smart filtering, previews, and safe recovery.
Alternatives in Development
- Mempalace Search — Search your memories across the MemPalace using semantic search with wing/room filtering 58.6k ★
- Diagnose Seq Scans — Remedy high seq scans on a table 7.2k ★
- Claude Keysmith — Managed Claude Code instruction deployment with safe CLI recovery and an unsigned macOS/Windows desktop beta 696 ★
README
🦾 The Claude
**Claude Code File Recovery Tool**
🚨 You Know This Feeling...
You've been **absolutely crushing it** with Claude Code for 2 hours:
- ✨ Created 12 files for your sick new project
- 🔥 Built that perfect API structure that just clicks
- 🎯 "I'll commit this shit in a minute..."
- 💥 Accidentally nuke the whole directory
- 😱 "OH NO! My entire session is GONE!"
**Stop panicking.** Claude Code logs everything. The Claude gets it back.
Like the claw from Toy Story, it reaches deep into your conversation logs and rescues your files from the digital void. Your flow-state coding session isn't lost - it's just waiting to be recovered.
✨ Features
- 🔍 Auto-discovery: Automatically finds all Claude Code projects in
~/.claude/projects - 📁 Smart scanning: Parses conversation logs to find Write, Read, Edit, and MultiEdit operations
- 🎯 File type filtering: Filter by Python, JavaScript, Markdown, or any file type
- 👀 Content preview: See file content before recovery with
--preview - 🔄 Version detection: Shows when files have multiple versions available
- 💾 Flexible recovery: Recover to safe directories with structure preservation
- 🎯 Interactive selection: Choose exactly which files to recover
- 📊 Smart statistics: File type breakdowns, size summaries, and recovery reports
- 🛡️ Safety first: Creates backups before overwriting existing files
- ⚡ Fast scanning: Efficient JSONL parsing with progress indicators
🚀 Installation
# Clone and install
git clone https://github.com/nickpending/theclaude.git
cd theclaude
# Install with uv (recommended)
uv sync
uv run theclaude --help
# Or install globally
uv tool install .
theclaude --help
📸 Screenshots
Command Help

Smart Project Discovery
![Projects with file type breakdowns](scree
Related Skills
Claude Code Session Recovery
Diagnose and repair Claude Desktop session metadata bugs on Windows and Mac — missing conversation history, lo
Claude Code Plus
Enhancements for Claude Code CLI: smart piped command auto-approval, shell config fix, and 850+ pre-configured
Cc Waste
Scans your local Claude Code session logs and generates a self-contained HTML report of token usage, cost, and
Pi Research
Web research for your agents with smart and safe tooling + knowledge store
ClaudeTokenSAP
⚡ Claude Code plugin to reduce token usage by up to 70% with smart compression for logs, JSON, and large conte
Concordia
Multi-agent CLI session coordinator. Tracks active Claude Code / Gemini CLI / Codex CLI sessions per repo, rec
Related Agents
Data Recovery
Use PROACTIVELY and automatically — do not wait to be asked — as the operator's cross-platform DATA RECOVERY g
Coppers
Git agent for commits, branches, and PRs/MRs on GitHub and GitLab. Smart commit messages, risk-tiered confirma
Recover
Recover lost context from compacted sessions by searching Aspy logs