cmux-recover-sessions

Scan persisted .jsonl files to recover crashed Claude Code sessions into cmux workspaces.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Bulk recover Claude Code sessions after crash or power loss by scanning persisted .jsonl files and re-opening them in cmux workspaces, without touching live workspaces or deleting data.

Core Features & Use Cases

  • Scans on-disk .jsonl session data to locate crashed or unsaved conversations.
  • Reopens sessions in cmux workspaces with safe, non-destructive behavior.
  • Provides interactive recovery planning and layout options for tab or split workspaces.

Quick Start

Run cmux-recover-sessions with a date range to scan and recover crashed sessions into cmux workspaces.

Frequently Asked Questions about cmux-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 crash?▼

Recover Claude Code sessions after a crash by scanning persisted .jsonl files and rehydrating them into cmux workspaces. This process safely reconstructs workspaces without altering live environments or deleting existing data.

Can I bulk recover unsaved Claude Code conversations from disk?▼

Yes, you can bulk recover unsaved Claude Code conversations by scanning on-disk .jsonl session data. The tool locates crashed or unsaved conversations and reopens them in cmux workspaces using non-destructive behavior.

Does recovering crashed Claude Code sessions require cmux to be running?▼

Yes, recovering crashed Claude Code sessions requires cmux to be running and the cmux-recover-sessions script installed. It supports interactive prompts to select scope, layout, and confirmation before executing the recovery.

What's the best way to restore Claude Code workspaces after power loss?▼

The best way to restore Claude Code workspaces after power loss is to run cmux-recover-sessions with a date range. This scans persisted .jsonl files and provides interactive recovery planning and layout options for tab or split workspaces.

Will session recovery modify my live workspaces or delete data?▼

No, session recovery will not modify your live workspaces or delete data. The tool scans on-disk .jsonl session data to reconstruct workspaces with safe, non-destructive behavior, requiring confirmation before execution.