Codex
Built-in Terminal UI and native app-server Chat support for the user's Codex installation.
AO uses the locally installed codex executable and Codex-owned authentication.
ao agent ls
ao spawn --project my-app --name codex-task --agent codex --mode chatInterfaces
- Terminal UI: runs the native Codex CLI in the session worktree.
- Chat: connects to Codex's native app-server protocol and persists the provider conversation identity with the AO session.
Codex supports the same capability-gated Chat/Terminal UI handoff as Claude Code. The AO session and worktree remain stable across a compatible handoff.
AO performs bounded installation and authentication probes before spawn. Use --skip-agent-check only to bypass that advisory CLI preflight; daemon validation remains authoritative.
Accounts
Open Settings → Agents → Codex to view the device’s current Codex account, add another account through Codex’s native login terminal, or switch the device to a verified account. AO derives each card label from the verified account, so there is no name prompt. Supported Codex builds can also provide plan, remaining-capacity, reset, and usage details.
AO keeps inactive credentials in private account slots, but ordinary AO Codex launches use the normal device Codex home. Exactly one account is active device-wide. Switching updates and verifies that device-global credential atomically; new Codex launches briefly wait for activation and then use the selected account.
Running AO Codex sessions and reviewers are left untouched during account switching. Existing turns continue best-effort, while new controller launches use the selected account. Resume or restart an existing session manually when you want to relaunch its controller under the active account.
Other Codex clients on the device—such as Terminal, IDE, and ChatGPT integrations—are not controlled by AO. AO never parses or exposes auth.json and does not scrape billing information. You can sign an account out; an inactive signed-out account can then be deleted. Per-task selection, assisted switching, automatic account selection, rename, reorder, and in-place replacement are not part of this release.