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.