cmux-recover-sessionslisted
Install: claude install-skill devseunggwan/praxis
# Recover Sessions (cmux)
> ⚠️ **Wrong skill?** If you have a JSON snapshot you previously saved with
> `cmux-save-sessions` and just want to rehydrate that exact layout, use
> **`cmux-resume-sessions`** instead. Recover scans the on-disk `.jsonl` files
> Claude Code persists automatically — useful precisely *because* you never
> got a chance to save anything before the crash.
## Overview
Bulk recover Claude Code sessions after crash or power loss into cmux workspaces.
cmux variant of `recover-sessions` — replaces tmux backend with cmux workspace/split API.
**Core principle:** Claude Code conversations are safely persisted to disk as `.jsonl` files. Recovery = find saved sessions and open them in cmux workspaces.
## The Iron Law
```
RECOVERY IS NEVER DESTRUCTIVE. LIVE WORKSPACES MUST NOT BE TOUCHED.
```
Recovery reads `.jsonl` files and re-opens them in new cmux workspaces. It must never:
- Close or replace any currently running cmux workspace
- Overwrite or delete saved conversation files
- Modify working directories — `cwd` is informational only
## When to Use
- After a Bun segfault crash that killed a Claude Code session
- After a Mac power loss when all cmux workspaces are gone
- After reboot when previous work sessions need to be restored
## Prerequisites
- `cmux-recover-sessions` script bundled at `${CLAUDE_SKILL_DIR}/cmux-recover-sessions`; no install step (`scripts/install.sh` can additionally symlink it into `~/.local/bin` for running the tool from a termi