Codex Agent

Use this skill to run Codex tasks via the ai_cli runner. This is intended for Claude to delegate work to Codex when appropriate, including long-running background tasks that can be monitored while other work continues.

Invocation

Call the runner script (installed path in projects is .claude/scripts):

bash
python3 .claude/scripts/sc_codex_task.py --json '{...}'

Use sc_codex_task.py only (do not call other runner script names). Do not invent flags like --run_in_background, --description, --prompt, or --subagent_type.

Input

Provide Task Tool input JSON with:

• description
• prompt
• subagent_type (defaults to sc-codex if not provided by the caller)

Notes

• Model flags (aliases and full names are accepted):
• --model codex (default: gpt-5.2-codex)
• --model codex-max or --model max (maps to gpt-5.1-codex-max)
• --model codex-mini or --model mini (maps to gpt-5.1-codex-mini)
• --model gpt-5 (maps to gpt-5.2)
• Background mode:
• Default is background unless --no-background is provided.
• Add --background to force background explicitly.
• Add --no-background to force blocking mode.
• The JSON output includes output_file (JSONL transcript path) and agentId.
• Poll output_file via a short Python loop (avoid tail -f and avoid timeout, which may be missing on macOS).
• Blocking mode (default without --background) returns { "output", "agentId" }.
• The runner enforces schema validation and logs to .claude/state/logs/<package-name>/.