skills.rest
MaxWolf-01
MaxWolf-01COMMUNITY
Explore all skills by this author →
Website𝕏@MaxWolf_01GitHub

restore-sessions

Scan Claude Code session files and classify unfinished work for resuming.

3|Updated Jan 10, 2026
Search Tags:#claude code#session management#developer productivity#triage#workflow recovery#resume sessions#jsonl parsing
One-click install
npx skills add https://github.com/MaxWolf-01/agents --skill restore-sessions-maxwolf-01
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: restore-sessions
Source: https://github.com/MaxWolf-01/agents/tree/main/mx/skills/restore-sessions
Command: npx skills add https://github.com/MaxWolf-01/agents --skill restore-sessions-maxwolf-01

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires tyro, and includes scripts (resource) components.

What problem does it solve? After crashes, restarts, or long breaks, developers lose track of which Claude Code sessions contain unfinished work. This Skill scans a project's session directory and produces a triage table showing what each session was about and whether it ended, so nothing in progress gets forgotten. ## Core Features & Use Cases - Session Scanning: Parses .jsonl session files in ~/.claude/projects/<project-path>/ and extracts topics, message counts, and completion signals (commits, transcripts, handoffs). - Status Classification: Labels each session as DONE, JUNK, or UNFINISHED with specific sub-states like MID-IMPLEMENTATION or COMMIT PENDING based on the last messages exchanged. - Resume Support: Outputs full session IDs so you can continue work directly with claude --resume <id>. - Use Case: Your machine rebooted overnight and you had five agent sessions open. Run this Skill to get a table of all recent sessions, instantly spot the two that were mid-implementation, and resume them by ID. ## Quick Start Ask the assistant to scan my recent Claude Code sessions from the last 10 days and show me which ones have unfinished work.

Frequently Asked Questions about restore-sessions

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

FAQPage Schema
How do I find unfinished Claude Code sessions after a crash?▼

Run the scan_sessions.py script against your project's session directory under ~/.claude/projects/. It outputs JSON summaries of each session including completion signals and interruption markers, which the Skill classifies into a DONE/UNFINISHED table with session IDs for resuming.

How to resume a previous Claude Code session by ID?▼

Use the command claude --resume <session_id> with the full UUID from the session table. The Skill outputs complete session IDs specifically so you can copy them directly into this command.

Where does Claude Code store session files?▼

Sessions are stored as .jsonl files in ~/.claude/projects/<project-path-with-dashes>/, where the project path has slashes replaced with dashes. For example, /home/user/repos/myapp becomes -home-user-repos-myapp.

Why is my current session showing up in the scan results?▼

The current session should be excluded by passing its ID via the --exclude flag, since any search text you pasted appears in its jsonl. The current session is always the most recently modified file in the sessions directory.

What counts as a finished versus unfinished session?▼

A session is DONE when it has completion signals (commit, transcript save, handoff) confirmed by the final assistant message. It is UNFINISHED when work continued after a commit, the last user request was never addressed, or the session was interrupted mid-task.

Related Skills

Explore More Software Engineering Skills→
tcdenttcdent

get-history-filename

Locate JSONL transcript files for Claude Code and Codex sessions via tmux pane tracing.

Community
Advanced
MINT-IAMINT-IA

gsd-resume-work

Restore project session context from STATE.md and checkpoint files.

Official
Advanced
salavendersalavender
47

compound-docs

Document solved problems into docs/solutions with searchable tags and validated YAML frontmatter.

Community
Advanced
czueczue

session-logs

Search and analyze session JSONL files with jq.

Community
Intermediate