Credentials. The transcript is copied into a new session file; check that it holds no secrets you do not want in the Codex session store, since auth and config stay with the source client but conversation text moves.
Who it is forA developer who started a task in Claude Code and wants to continue it in Codex without re-explaining the context.
The problemSwitching coding agents usually loses the conversation history and the work already done in the earlier session.
The outcomeA new native Codex session with the earlier messages and tool results, which the developer can resume from the project folder.
What you need first
- Linux with Python 3.11+ (the README lists these as the currently supported platform)
- uv or pipx to install the CLI
- A native session file from the source client, such as a Claude Code JSONL transcript
- The target client installed locally, for example Codex, to resume the migrated session
Steps
- Install the CLI with
uv tool install session-migrate. - Find the Claude Code session UUID you want to move.
- Run
smigrate transfer SESSION_UUID --from claude --to codex --cwd "$PWD"from the project directory. - Note the NEW_SESSION_UUID that the transfer prints.
- Resume the session with
codex resume NEW_SESSION_UUID.
Prompt for your agent
Use the xhluca/session-migrate repo to transfer the Claude Code session with UUID <SESSION_UUID> to <TARGET> (codex) using --cwd set to the current project directory. Report the new session UUID the command prints. Verify that the report includes a new target session ID and that the source Claude transcript was not modified.
Caveat. The README says same-format or cross-format migration creates a new independent session, not a live sync, so later edits in one client will not appear in the other.
Use this in your AI agent
Ask your agent
Using the Deduped MCP, get the setup steps for xhluca/session-migrate and "Continue a Claude Code session in Codex"
Add Deduped to Claude Code once
claude mcp add --transport http deduped https://dedupedai.com/mcp
Every Monday: the 5 hottest repos and exactly how to use them. Free, one email a week, unsubscribe anytime.
Get them freeShare: X LinkedIn Hacker News Email Copy link
Third-party repos we don't own. AI-written use cases can be wrong. Disclaimer