| name | resume-claude-session |
| description | Recover bounded context from a Claude session for the current workspace and stop after asking whether to continue. Use when resuming work from Claude artifacts inside Codex. |
Recover context from a Claude session. This is a recovery workflow, not native session restoration.
Use this playbook:
-
Resolve the helper path.
Prefer ./skills/resume-claude-session/runtime/ripcord_helper.py when the current workspace is this repository.
Otherwise use the installed skill helper at ~/.codex/skills/resume-claude-session/runtime/ripcord_helper.py.
If neither path exists, tell the user the skill helper is unavailable and stop.
-
Build the recovery command for the current workspace.
Base command:
python3 "<helper>" recover --source claude --workspace "$PWD"
If the user already supplied a specific Claude session id, append:
--session-id "<session-id>"
-
Run the recovery command and inspect the JSON result.
-
If status is not_found, briefly explain that no Claude session matched this workspace and stop.
-
If status is needs_selection, present the ranked candidates with:
session_id, updated_at, preview, reasons, and whether the match is exact.
Ask the user which session id to recover next. Do not guess.
-
If status is ready, compact and present only the bounded recovery fields:
source session metadata, initial user prompt, recent user messages, recent assistant messages, recent tool uses, and any warnings or truncation notes.
-
End by asking whether to continue from that recovered point.
Do not take action yet.
Do not claim the Claude session has been restored natively.
Do not dump the full raw transcript when the helper already returned bounded context.
