codex-subagent

npx skills add sickn33/agentic-awesome-skills --skill codex-subagent --agent codex

Same command for any agent — swap --agent for claude-code, cursor, copilot.

# Codex CLI as a Subagent ## When to Use - Use when a bounded coding, review, or verification task can run in a separate Codex CLI session. - Use when parallel work needs explicit file ownership and a clear definition of done. Codex CLI is OpenAI's terminal coding agent. `codex exec` runs it non-interactively: it works autonomously in a sandbox, streams progress to stderr, and prints only the final message to stdout. Auth reuses the user's ChatGPT subscription — never an API key. ## When to delegate - Self-contained coding task with clear success criteria (fix, feature, refactor, review). - Parallel work: several independent tasks at once (see Parallel runs). - Second opinion / independent verification of your own changes. Do NOT delegate tasks that need conversation context you can't fully write into the prompt. ## Preflight ```bash codex --version # missing? npm i -g @openai/codex (or: brew install --cask codex) codex login status # exit 0 + "Logged in using ChatGPT" = ready ``` Not logged in → stop and tell the user to run `codex login` (one-time browser OAuth). Never read, print, or copy credentials (`~/.codex/auth.json`). ## Launch ```bash OUT=$(mktemp /tmp/codex-out.XXXXXX) c

codex --version       # missing? npm i -g @openai/codex  (or: brew install --cask codex)
codex login status    # exit 0 + "Logged in using ChatGPT" = ready
codex exec \
cat "$OUT"                            # final message = the deliverable
git -C /path/to/repo status --short   # see what Codex actually changed
codex exec resume --last "follow-up instruction" </dev/null
git worktree add /tmp/wt-taskA -b codex/task-a
codex exec --cd /tmp/wt-taskA --sandbox workspace-write -o /tmp/outA.md "task A" </dev/null