Skip to content

About

Recover Codex sessions into Claude Code handoffs

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

1 Commit

Folders and files

Repository files navigation

codex-session-handoff

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

Install as a Claude Code plugin:

python3 scripts/install_plugin.py

If you prefer a copy instead of a symlink:

python3 scripts/install_plugin.py --mode copy

Use

Prompts like these should trigger the skill after installation:

  • Resume my last Codex session
  • Recover a Codex session and give me a Claude handoff
  • Find my recent Codex sessions

Development

Run tests:

python3 -m unittest discover -s tests -v

Run 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

About

Recover Codex sessions into Claude Code handoffs

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages