Handoff to Codex CLI

SkillProductivity

Continue a task in OpenAI Codex CLI through a portable Director handoff packet. Use when the user asks Codex to take over, wants an independent Codex implementation or review, or needs to preserve decisions and verification while changing CLIs.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Handoff to Codex CLI skill

What this skill tells your AI

The instructions your AI receives, as published by claude-world/director-mode-lite in skills/handoff-codex/SKILL.md and read by ahel’s review.

Use the shared session-relay workflow. Codex starts its own native session and reads a packet containing the goal, current state, decisions, Git evidence, verification, and next steps.

ROOT="${CLAUDE_PROJECT_DIR:-${GROK_WORKSPACE_ROOT:-}}"
[[ -n "$ROOT" ]] || ROOT="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
RELAY="$ROOT/.director-mode/bin/director-relay"
[[ -x "$RELAY" ]] || RELAY="$HOME/.claude/bin/director-relay"

"$RELAY" create \
  --from <claude|grok> --to codex \
  --goal "..." --summary "..." --next "..."

"$RELAY" continue --to codex

The second command prints the interactive codex invocation. Add --run only when the user wants it launched now. Use --headless when a one-shot codex exec continuation is appropriate.

Codex reads the repository's AGENTS.md, reusable skills from .agents/skills/, and generated agents from .codex/agents/. Confirm those surfaces with the installed CLI when debugging discovery.

Do not add bypass, approval, sandbox, or network flags as part of the handoff. Those controls belong to the Codex session and remain at their current native settings.

Signals

GitHub stars
81
Forks
11
Last commit
Aug 2026
Advanced
Catalog kind
skill
Gateway key
handoff-codex
Source
github.com/claude-world/director-mode-lite