Recover a previous Codex session into a Claude Code handoff from local Codex transcript files, without calling Codex in the normal path.
This mirrors claude-session-handoff, but in the other direction: Claude Code can find recent Codex sessions, show a stable picker, resolve the selected transcript, and summarize it into a compact handoff.
Install as a Claude Code plugin:
python3 scripts/install_plugin.pyIf you prefer a copy instead of a symlink:
python3 scripts/install_plugin.py --mode copyPrompts like these should trigger the skill after installation:
Resume my last Codex sessionRecover a Codex session and give me a Claude handoffFind my recent Codex sessions
Run tests:
python3 -m unittest discover -s tests -vRun the scripts directly:
python3 scripts/discover_sessions.py --cwd "$PWD" --limit 5 --picker
python3 scripts/discover_sessions.py --cwd "$PWD" --limit 5 --json --snapshot-out /tmp/codex-session-handoff-snapshot.json
python3 scripts/resolve_session_choice.py --snapshot /tmp/codex-session-handoff-snapshot.json --choice 1 --field file_path
python3 scripts/summarize_handoff.py --session /path/to/codex-session.jsonl --json