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

):

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>/

  .