Claude Session Handoff

Recover the state of a prior Claude Code session, then confirm what actually exists in the current workspace before continuing.

Workflow

1. Find the right session

Default to the current project path unless the user gives a specific JSONL file.

For the common handoff case, do not search every Claude transcript first. Bias toward the current repo, the most recent top-level session, and recent activity.

Run the helper script:

python3 scripts/claude_session_handoff.py --project-path "$PWD"

Useful variants: