recover-sessions

Scan saved .jsonl session files and recreate Claude Code sessions in tmux panes.

Updated Jan 6, 2026
One-click install
npx skills add https://github.com/devseunggwan/praxis --skill recover-sessions
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: recover-sessions
Source: https://github.com/devseunggwan/praxis/tree/main/skills/recover-sessions
Command: npx skills add https://github.com/devseunggwan/praxis --skill recover-sessions

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Bulk recover Claude Code sessions after power loss or tmux server crash. Claude Code conversations are saved to disk as .jsonl files, enabling safe restoration without impacting live work.

Core Features & Use Cases

  • Scan recent Claude Code sessions and identify recoverable work without touching live sessions.
  • Recreate recovered sessions in a configurable multi-window tmux layout for rapid resumption.
  • Guided interactive prompts to determine recovery scope, layout, and execution mode with safety checks.

Quick Start

Start the recovery process by running claude-recover to scan recent Claude Code sessions and begin the guided, non-destructive restore.

Frequently Asked Questions about recover-sessions

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

FAQPage Schema
How do I recover Claude Code sessions after a tmux server crash or power loss?

Yes, bulk session recovery is safe because the process enforces non-destructive recovery with safeguards to avoid touching live sessions. It scans saved .jsonl files and requires user approval before recreating any tmux panes.

How does scanning .jsonl files help restore lost Claude Code workspaces?

Scanning .jsonl files identifies recoverable Claude Code conversations saved to disk. The Skill reads these session files to reconstruct your previous workspaces in a new tmux layout without impacting currently active sessions.

Can I customize the tmux layout when restoring multiple Claude Code sessions?

Yes, you can customize the tmux layout during the interactive interview. The recovery process prompts you to determine the specific recovery scope, desired multi-window layout, and execution mode before recreating the panes.

Do I need to manually close active tmux panes before starting session recovery?

No, you do not need to close active panes manually. The recovery process includes built-in safeguards to avoid touching live sessions, ensuring your existing work is preserved while only targeting recoverable .jsonl session files.

What's the best way to bulk resume Claude Code sessions without losing existing work?

The best way to bulk resume sessions non-destructively is running claude-recover. It scans recent saved .jsonl files, uses an interactive interview for setup, and recreates sessions in a new tmux layout while preserving active work.