Codex

Sources#

• Coding Agents and Technical Debt
• Models are worse at reviewing their own code
• OpenAI Codex lead on the new shape of product work
• The Shift to Agentic AI: Evidence from Codex

Summary#

Codex is OpenAI's agentic coding and work platform — the OpenAI-side counterpart to Claude Code throughout this wiki. Released April 2025 as a command-line tool, it grew into a multi-surface agent harness: a threaded interaction model (independent per-task workspaces), reusable skills and installable plugins, a headless App Server Protocol for programmatic sessions, and the Symphony orchestrator that turns Linear into a control plane for it. Originally built for software development — a domain with verifiable, economically valuable, modular outputs — its usage has spread well beyond code into research, drafting, data analysis, and operations.

What it is, in this corpus#

• The agent harness. Built on the GPT-5-series Codex models; runs multi-step, tool-using, file-modifying tasks. Its threaded model is what enables parallel agent orchestration — many independent agents at once.
• The systematization layer. Skills (SKILL.md workflow specs) + plugins (installable bundles of skills, MCP integrations, hooks) are the substrate of Agentic Work Systematization; a skill authors a workflow, a plugin distributes it.
• The headless protocol. The App Server Protocol (JSON-RPC over stdio) drives Codex non-interactively — the basis for orchestration and CI-style use.
• The orchestrator. Symphony (OpenAI open-source, March 2026) coordinates per-issue Codex workspaces from a Linear board.
• The usage subject. OpenAI's June 2026 Shift to Agentic AI study measures Codex adoption across individual, organizational, and OpenAI-internal populations — weekly-active usage up >5× in H1 2026, increasingly outside the developer base.

The desktop app (Ambrosino's account)#

The wiki's original Codex entry is the CLI + orchestration stack. Andrew Ambrosino's June 2026 interview describes the desktop app — a distinct surface with its own history and trajectory:

• Timeline. The team started the app in November 2025, dogfooded it internally, and released it in February 2026. Ambrosino stresses it was a right-sized surface — "sort of a chatbot, but more than that; you could see the code but we weren't going to let you edit it" — deliberately not an IDE.
• Usage (first-party, unverified). He reports ~90% of OpenAI's entire company (not just engineers) uses Codex, ~100% of employees weekly; 5M+ weekly active users, grown ~6× since January. vendor-claim-tier figures from a product leader.
• From developer tool to general knowledge work. The pivotal internal discovery: non-engineers (marketing, comms, finance, legal) used the Codex app "even though it is actively hostile to these people" — showing them code, asking to run rg. Attempts to build separate general surfaces failed because "nobody would leave the Codex app." The strategy became one "home base" — start simple, grow complex per user, connect out to specialist tools (it talks to the Excel add-in for finance; opens other apps to finish work) — with the "super app" label Ambrosino says he regrets having to hear about.
• Self-extension. The signature anecdote: OpenAI's in-house videographer edited launch videos with Codex, which — not being a video editor — built its own Premiere Pro extension to control Premiere by editing the backing files and then talking to the extension it wrote. The agent extends itself into a specialist tool it wasn't designed for.
• Interaction-modality design. The app juggles connectors, an in-app browser (now on the Atlas "owl" stack with enterprise login), a Chrome-extension bridge, and computer use — Ambrosino calls choosing among them a live, unsettled design problem (keyboard-shortcut mapping, "browser at the top level vs. agent-only browser"). Computer use lets it "just start clicking" through UIs with no API (e.g. the Google Cloud console).
• Automations as an OpenClaude-style operator. Ambrosino runs scheduled tasks that triage his ~3,000 Slack channels into a daily brief he steers in natural language — an emerging first-class pattern the team wants to make setup-free for non-builders.

The app is also the setting for Ambrosino's product theses: Implementation Abundance Inverts Product Work, "the February app would have failed in November — only the models changed", and Why AI Lags at Design.

The ChatGPT Work merge (Nathan's account, July 2026)#

A month after Ambrosino's interview, Codex stopped being a separate product. Akshay Nathan — who leads product engineering for OpenAI's productivity team — describes the outcome on Latent Space (Codex from 0 to 10M Users: Building ChatGPT Work - Akshay Nathan, OpenAI, practitioner-opinion): ChatGPT Work (launched July 9, 2026) runs on the Codex harness. Full treatment of the architecture at Shared Harness, Differentiated Surfaces; the Codex-specific facts:

• The harness is literally shared, and only the UX layer is opinionated per surface: git-state visibility (the "dynamic island" assumes a repo), diff-forward chain-of-thought display, and sandboxing defaults. Everything else — plugins, computer use, artifacts, memory, sub-agents, scheduled tasks — is the same in both modes, by principle: "everything that you can do in the Codex portion of the product on desktop, you can do in ChatGPT Work and vice versa."
• The classic ChatGPT harness still exists for chat (optimized for latency and personality, running the "instant" model); the Codex harness is what knowledge work now runs on, because "if you give the agent access to this infinitely flexible environment as a computer, it can do really powerful things." Nathan frames harness history as "divergence, convergence, divergence, convergence" rather than replacement. Routing between them is a model decision, not a router — "this is the decision that the model is making."
• Adoption (first-party, unverified). OpenAI said ChatGPT Work + Codex reached 10M combined users within two weeks of the July 9 launch; the counts merged because the harness merged. Nathan calls this "a culmination" but stresses ChatGPT as a whole has hundreds of millions of users, and Work is paid-only, not defaulted on. Earlier in June, OpenAI put knowledge workers at ~20% of Codex's base, growing >3× as fast as developers. All vendor-claim-tier.
• Codex stays as a brand, deliberately. "Developers have been a core market for us for so long… this doesn't take away from that at all. If anything, it should increase the utility of something like Codex, because now you can move seamlessly between writing a diff to creating an artifact or doing a search."
• New shared primitives from the Work push: artifacts (agentic Excel/PowerPoint/Docs editing, with a "pretty dramatic" model-side quality jump Nathan attributes to GPT-5.4→5.5→5.6); Sites (hosted HTML, increasingly the canonical team artifact in place of decks and spreadsheets — see HTML as the New Markdown); a persistent computer environment with a file system whose files survive between sessions; and scheduled tasks. Nathan credits OpenClaw for the last two: "it has all the same primitives… scheduled tasks, the ability to store files on a file system, the ability to reference those things over time."
• Ultra (multi-agent mode) was moved behind advanced settings post-launch and made opt-in, because it "can use more of your limits"; sub-agent transcripts are hidden by default.

The codebase, measured from outside (July 2026)#

The one third-party accounting of Codex-the-repository in this corpus comes from a competitor: OpenHands' twelve-month GitHub analysis (Coding Agents and Technical Debt, case-study). For openai/codex alone, in the year to 2026-07-08: 7,688 merged PRs, 1,202 of them bug fixes (16% — the lowest share of the four harnesses compared), ~3.8M lines changed, ~1.32M lines of current code — the largest merged-PR count and the second-largest codebase in the comparison. The acceleration is the sharper figure: Codex went from ~124 merged PRs/month in mid-2025 to ~1,000/month a year later. And the single-repo layout matches the platform shape described above — "the CLI, dozens of core runtime crates, an app server, MCP support, and Python and TypeScript SDKs" all live in the one repo, so this understates total Codex work wherever it happens privately or elsewhere. See Harness Build-vs-Buy.

The /review feature, traced from outside (July 2026)#

Greptile's research team ran Codex's /review and Claude Code's against 1,000 labelled pull requests (Same-Model Review Blindness, case-study, from a vendor selling a competing reviewer). Two product-level observations, distinct from anything about the underlying model: a Codex review lands at 1–2 comments where Claude Code's lands at 7–8, and the GPT 5.5 traces underneath show the terseness is at least partly prompt-and-post-training, not capability — the model names a deadlock in its reasoning and posts only a lower-severity finding, and recall recovers once an instruction to target 7–10 comments is added. Caridad's diagnosis is that OpenAI's stock /review system prompt aggressively narrows scope to minimize noise, and that Deliberative Alignment makes the model weigh developer-versus-user intent before acting: "the model was not disobedient — it was doing exactly what it was trained to do." Read as a measurement of a shipped default rather than of GPT 5.5.

Codex vs. Claude Code#

The two are the wiki's reference harnesses, repeatedly compared. Loop Engineering's central structural claim is that both now ship the same five primitives (automations, worktrees, skills, connectors/plugins, sub-agents) under different names, so the same agent loop works in either — evidence for harness shrinkage. Where they diverge is institutional: Codex sits inside OpenAI's GPT-5 ecosystem and the Symphony/App-Server orchestration stack; Claude Code inside Anthropic's. The "harness engineering" framing (OpenAI, April 2026) is Codex's house philosophy for an agent-first workflow.

Connections#

• OpenAI — maker; Codex is OpenAI's agent-tooling thread in this corpus
• Claude Code — the Anthropic-side peer harness Codex is compared against (same five loop primitives, different ecosystem)
• Symphony — OpenAI's open-source orchestrator that drives Codex from Linear
• Codex App Server Protocol — Codex's headless JSON-RPC protocol
• Conversation-to-Delegation Shift — the June 2026 usage study built on Codex telemetry; its adoption curve and token-share data
• Agentic Work Systematization — Codex's skills/plugins are the systematization substrate that study measures
• Parallel Agent Orchestration — Codex's threaded model is what enables the concurrency the study documents
• Loop Engineering — Codex as one of the two tool surfaces that now ship all five loop primitives
• Harness Shrinkage as Models Improve — Codex absorbing harness capability (skills, automations, worktrees) into named product primitives
• Shared Harness, Differentiated Surfaces — the architecture of the ChatGPT Work merge: one harness, three UX differentiators, and why OpenAI rejected the separate-products shape Anthropic chose
• Andrew Ambrosino — product & engineering lead for the Codex desktop app; the source for the app's history, usage, and general-knowledge-work pivot
• Implementation Abundance Inverts Product Work — the product-process thesis Ambrosino draws from building Codex
• Build for the Next Model — the Codex app as the case study: same shape, different-intelligence releases (Nov→Feb; Operator→Atlas→Codex)
• Why AI Lags at Design — Ambrosino's design-capability read, developed while building the app's front end
• Role Averaging, Not Role Elimination — the "role collapse" the Codex org saw more of than the rest of OpenAI
• Harness Build-vs-Buy — the outside measurement of the Codex codebase (7,688 merged PRs/year, ~1.32M lines, ~124 → ~1,000 PRs/month) and what it implies about forking any harness
• OpenHands — the open-source competitor that published the comparison
• Same-Model Review Blindness — Codex's /review as one of the two measured reviewers, and the finding that constrains it: GPT 5.5 is at its weakest on Codex-authored PRs (50.5% high-severity recall against 62.0% on Claude-authored ones), so the harness's own review command is least sensitive to the code the harness itself writes

Sources#

• The Shift to Agentic AI: Evidence from Codex — OpenAI, June 2026 (Codex usage across three populations)
• OpenAI Codex lead on the new shape of product work — Lenny's Podcast, June 2026 (Ambrosino on the Codex desktop app, its usage, and its trajectory)
• Codex from 0 to 10M Users: Building ChatGPT Work - Akshay Nathan, OpenAI — Latent Space, 2026-07-28 (practitioner-opinion): Akshay Nathan on the ChatGPT Work merge, the shared harness, artifacts/Sites, the persistent computer environment, and the 10M-user claim
• Coding Agents and Technical Debt — Rajiv Shah, OpenHands, 2026-07-28 (case-study, competitor-authored): third-party GitHub activity data for openai/codex
• Models are worse at reviewing their own code — Rodrigo Caridad, Greptile, 2026-07-21 (case-study — corrected from the raw's empirical at compile; competitor-authored): Finding 3 (comments per review) and Finding 4 + FIG. 05/06 (the omitted-deadlock trace and its recovery under comment-count guidance). Full treatment at Same-Model Review Blindness
• Also referenced in: An open-source spec for Codex orchestration: Symphony., Harness engineering: leveraging Codex in an agent-first world, Loop Engineering