← ClaudeAtlas

cmux-recover-sessionslisted

Bulk recover Claude Code sessions after a crash, power loss, OOM kill, or reboot by scanning the .jsonl files Claude Code persists automatically. Interactive interview chooses recovery scope and layout. Use this when sessions died and you need them back, NOT for restoring an intentionally saved layout. Priority: crash context wins. If the request mentions a crash/power loss/OOM, prefer this skill even when the user also mentions a snapshot — the snapshot may be stale, and .jsonl scan reflects the real final state. Only defer to cmux-resume-sessions when there is NO crash context and the user explicitly wants to rehydrate a saved snapshot.
devseunggwan/praxis · ★ 1 · Web & Frontend · score 73
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