recover

Scan git worktrees and branches for orphaned sessions and stale refs.

9|1|Updated Mar 26, 2026
One-click install
npx skills add https://github.com/conorbronsdon/claude-code-skills --skill recover-conorbronsdon
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: recover
Source: https://github.com/conorbronsdon/claude-code-skills/tree/main/recover
Command: npx skills add https://github.com/conorbronsdon/claude-code-skills --skill recover-conorbronsdon

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you find and safely clean up orphaned git worktrees, stale branches, and leftover session artifacts after crashes or abandoned Claude Code runs.

Core Features & Use Cases

  • Worktree inspection: Lists active, orphaned, and stale worktree entries so you can see what is truly abandoned.
  • Branch hygiene: Identifies merged, stale, and active branches to separate safe deletions from items that need review.
  • Approval-gated cleanup: Recommends precise git cleanup actions and waits for explicit approval before changing anything.
  • Use case: After a forced shutdown or a messy parallel-session workflow, it helps you restore repository hygiene without losing unmerged work.

Quick Start

Ask Claude to scan the repository for orphaned worktrees and stale branches, summarize the cleanup options, and wait for your approval before making any changes.

Frequently Asked Questions about recover

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I clean up orphaned git worktrees after a crash?

To clean up orphaned git worktrees, scan the repository to detect stale worktree entries, classify their status, and apply approval-gated cleanup recommendations that preserve unmerged work before removing anything.

What is the best way to find stale git branches without losing uncommitted work?

The best way to find stale git branches safely is to inspect branch refs, classify them as merged, stale, or active, and only proceed with deletions after an explicit approval gate ensures unmerged work is preserved.

How does session recovery work for abandoned Claude Code runs?

Session recovery for abandoned runs scans git worktrees and branches to detect leftover repository state, classifies orphaned sessions, and recommends precise cleanup actions while waiting for explicit approval before changing anything.

Can I remove stale worktree refs during parallel branch maintenance?

Yes, you can remove stale worktree refs during parallel branch maintenance by scanning for orphaned entries, classifying their status, and applying approval-gated cleanup recommendations to restore repository hygiene without losing work.

When should I not delete stale git branches?

You should not delete stale git branches when they contain unmerged work, which is why an approval-gated cleanup process classifies active, stale, and merged refs first and waits for explicit confirmation before proceeding.