codex-delegate

What this does

Spawns the codex-delegate subagent (low-effort Sonnet), which runs codex exec with output redirected to a log and returns only a ~10-line summary. Routing lives in ~/.claude/CLAUDE.md § Codex Delegation; wrapper mechanics live in the agent definition. This file covers only the orchestrator side: how to spawn and what to do with the result.

How to invoke

1. Turn the request ($ARGUMENTS if given, else the current task) into a self-contained spec — Codex has no memory of this conversation, so include everything: exact behavior, file paths, edge cases, and how to verify.

2. Spawn the subagent (background), passing TASK, WORKDIR (default: current working directory), SANDBOX (workspace-write for edits, read-only for investigation), and a VERIFY command if there's a test/build to check.

   Preferred — the dedicated agent (available after a Claude Code restart that registers .claude/agents/codex-delegate.md):

   Agent(
     subagent_type: "codex-delegate",
     description: "delegate to codex",
     prompt: "TASK: <full self-contained spec>\nWORKDIR: <abs path>\nSANDBOX: workspace-write\nVERIFY: <test/build cmd or omit>\nTAKEOVER: allowed  # optional — lets the wrapper finish mechanical remainder itself if Codex is quota-blocked/crashed; omit to restrict it to salvage-only",
     run_in_background: true
   )
   

   Fallback — if that errors with Agent type 'codex-delegate' not found (the definition isn't loaded in this session yet), spawn a generic Sonnet subagent that reads the same playbook file:

   Agent(
     subagent_type: "general-purpose",
     model: "sonnet",
     effort: "low",
     description: "delegate to codex",
     prompt: "First Read /home/cong/.claude/agents/codex-delegate.md and adopt it as your complete role and instructions. Then carry out:\nTASK: <full self-contained spec>\nWORKDIR: <abs path>\nSANDBOX: workspace-write\nVERIFY: <test/build cmd or omit>",
     run_in_background: true
   )