Codex

Slot: agent · Name: codex · Binary: codex

OpenAI Codex CLI is a terminal coding agent from OpenAI. AO hooks into it via PATH wrappers and reads its native session JSONL for activity + cost.

macOSSupported

LinuxSupported

WindowsSupported

Install

npm install -g @openai/codex

agent-orchestrator.yaml

agent: codex

No plugin-level config.

Launch: codex runs inside the worktree. AO sets CODEX_DISABLE_UPDATE_CHECK=1 to keep the agent quiet about updates mid-session.
Activity tracking: Codex writes session events to ~/.codex/sessions/YYYY/MM/DD/<id>.jsonl. AO reads the last entry to determine active/ready/idle/waiting_input/blocked.
PR + git tracking: AO installs wrappers at ~/.ao/bin/gh and ~/.ao/bin/git. When Codex runs gh pr create, the wrapper records the PR number in the session metadata.
Session resume: codex resume <threadId> — AO stores the thread id in session metadata and replays it.

Variable	Set by AO	Purpose
`AO_SESSION_ID`	✓	AO session id
`AO_ISSUE_ID`	✓	Issue identifier
`PATH`	✓	Prepends `~/.ao/bin` for the wrappers
`GH_PATH`	✓	Absolute path to the real `gh`, used by the wrapper
`CODEX_DISABLE_UPDATE_CHECK`	✓ (`1`)	Skip version check

OpenAI API credentials come from wherever codex reads them — AO doesn't set them.