nickpending

Theclaude — Development skill for Claude Code

Development community

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 Logo

🦾 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

![The Claude Help](screenshots/help.png)

Smart Project Discovery

![Projects with file type breakdowns](scree