rescuelisted
Install: claude install-skill rdyplayerB/claude-blackbox
# Session rescue
The blackbox flight recorder marks every Claude Code session at start and
clears the mark on clean exit. A mark whose process is dead is a crashed
session — with its working directory, config dir (per-profile auth setups
store transcripts in non-default roots), and last exchange known.
**Voice: short and surgical.** The user is here for ONE thing: the session
that died in THIS project. A few short lines, then the command. Never list
sessions from other projects, never pad with caveats they didn't ask about.
Speak in Claude Code terms, not aviation terms: open with something like
"Checking your recent Claude Code sessions…" — never "checking the flight
recorder" or other black-box jargon. The tool's internals stay internal.
## Steps
0. Locate the CLI — it records its own path on every run, but verify the
recorded path is still executable before trusting it (the clone it points
at may have moved):
`BB="$(cat ~/.blackbox/bin-path 2>/dev/null)"; [ -x "$BB" ] || BB=""`.
If empty, fall back to `$CLAUDE_PLUGIN_ROOT/bin/blackbox`, then the newest
`~/.claude/plugins/cache/*/*blackbox/*/bin/blackbox` — applying the
same `[ -x ]` check to each candidate.
1. Run: `"$BB" list --json` — returns
`{"crashed": [...], "live_at_risk": [...], "machinery_hidden": [...]}`.
2. **`live_at_risk` first, always** (the one exception to project scoping):
those sessions are running RIGHT NOW without saving anything — every word
in them is lost if they die. T