Menu
Use when moving local sessions between Claude Code and Codex, converting Claude Code JSONL into Codex rollout format, converting Codex rollout JSONL into Claude scrollback, or debugging cross-agent resume state.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
This skill should be used when the user asks about libraries, frameworks, API references, or needs code examples. Activates for setup questions, code generation involving libraries, or mentions of specific frameworks like React, Vue, Next.js, Prisma, Supabase, etc.
Respond to code review comments point by point, quoting each reviewer point verbatim and answering directly beneath it.
Use when moving local sessions between Codex and Claude Code, converting Codex rollout JSONL into Claude scrollback, converting Claude Code JSONL into Codex rollout format, or debugging cross-agent resume state.
Operate remote hosts over SSH through the ssh-mcp server, driving a box like a person at a terminal instead of firing blind one-off commands.
Use when a task involves SSH or a remote host, including remote commands, interactive shells, sudo over SSH, tailing logs, deployments, scp or rsync file transfer, and port forwards or tunnels.
Use when drafting or editing prose or copy, including reports, research write-ups, guidance, documentation, READMEs, emails, announcements, summaries, blog posts, marketing copy, product copy, or any text meant to be read. Triggers whenever the user asks to draft, write, rewrite, edit, or polish copy. Applies GOV.UK and GDS house style, favoring plain English, active voice, front-loaded content, sentence case, and no bold or italics for emphasis.
| name | session-bridge |
| description | Use when moving local sessions between Claude Code and Codex, converting Claude Code JSONL into Codex rollout format, converting Codex rollout JSONL into Claude scrollback, or debugging cross-agent resume state. |
| when_to_use | Use when the user asks to move, import, export, bridge, fork, resume, or convert sessions between Claude Code and Codex. |
| argument-hint | [codex-to-claude|claude-to-codex] [session path] [project cwd] |
| allowed-tools | ["Bash"] |
| effort | medium |
Use the shared agent-session-bridge script from ~/bin or this repo's bin/.
Do not reimplement transcript conversion in the skill.
Find the Claude session if the user did not provide one:
agent-session-bridge find --agent claude --cwd "$PWD"
Convert it:
agent-session-bridge claude-to-codex \
--source <claude-session.jsonl> \
--cwd "$PWD" \
--model gpt-5.5 \
--update-state
Verify the result:
agent-session-bridge inspect --source <new-codex-rollout.jsonl>
Report the new session id and output path.
Find the Codex rollout if needed:
agent-session-bridge find --agent codex --cwd "$PWD"
Convert it:
agent-session-bridge codex-to-claude \
--source <rollout.jsonl> \
--cwd "$PWD" \
--model claude-opus-4-8 \
--update-state \
--copy-resume-command
Verify with agent-session-bridge inspect --source <new-claude-session.jsonl>.
--no-redact only if the user explicitly asks
and understands secrets may be copied.--include-internal only when
the user explicitly wants injected system/developer/AGENTS-style text.