| name | handoff |
| description | Switch from Claude Code to Codex without losing context. Packages the exact active session, recent decisions, and git state, then opens Codex. Use when Claude hits usage or context limits, changes models, or the user invokes /handoff or asks to continue in Codex. |
Handoff
Run the bundled launcher immediately. Do not manually summarize or paste the transcript into Codex.
For a Skills CLI installation, locate scripts/claude-to-codex.mjs beside this SKILL.md and run:
node <skill-directory>/scripts/claude-to-codex.mjs --session "${CLAUDE_SESSION_ID}"
Common skill directories are:
$HOME/.claude/skills/handoff<project>/.claude/skills/handoff$HOME/.agents/skills/handoff
Require a non-empty CLAUDE_SESSION_ID; do not silently choose the newest transcript. The launcher writes a
private package under ~/.claude/handoffs, resolves the target model from CLAUDE_TO_CODEX_MODEL or Codex
config, and dispatches Codex when a supported launcher is available. Relay the launcher result and manual
fallback command exactly.
The Claude Code plugin provides the deterministic namespaced command:
/claude-to-codex:handoff
Maintainers can use the direct Node CLI for recovery options such as --mode print, --codex-model,
--handoff-reason, --session, --latest, --transcript, --tail, --check, or
--codex-subagents:
node plugins/claude-to-codex/skills/handoff/scripts/claude-to-codex.mjs --mode print --latest --codex-model gpt-5.6-sol
Token rule: pass Codex a bounded pointer prompt plus hot context, handoff manifest, git snapshot,
digest, and transcript paths, not a full pasted transcript. Source-model safety/refusal verdicts do
not become continuation guidance; Codex assesses the original user request independently.
