# Codex Agent

> Run Codex tasks via the ai_cli Task Tool runner.

- Skill: `majiayu000/codex-agent` (Agent Skill, multi-file: 8 files)
- Install (CLI): `npx skillmds add majiayu000/codex-agent`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/codex-agent/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/codex-agent

---


# 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>/`.