Codex Record and Replay on macOS: Skill Routing Policy

Codex Record and Replay records a macOS workflow once, drafts a reusable skill, and turns replay into a routing problem: approval, fallback, recovery, and cost per skill.

TheRouter Newsroomvia OpenAI Developers
Minimal editorial diagram of Codex Record and Replay converting a human workflow into a reusable agent skill and routing policy

Codex Record and Replay changes a subtle but important adoption question for AI engineering teams: instead of asking every user to write a perfect prompt for a recurring workflow, OpenAI now lets a user demonstrate the workflow once and turn it into a reusable Codex skill. For teams already experimenting with coding agents, browser actions, and desktop Computer Use, the feature pushes agent work from ad hoc chat into repeatable workflow operations.

What happened

OpenAI added Codex Record and Replay to the Codex app on macOS. The official documentation says the feature lets a user demonstrate a workflow on a Mac, then have Codex inspect the captured steps and draft a reusable skill. That skill describes when to use the workflow, what inputs it needs, the steps to follow, and how to verify the result.

OpenAI positions Codex Record and Replay for workflows that are repetitive, preference-heavy, or easier to show than to describe in a prompt: filing an expense, booking a parking space, creating a correctly configured issue, publishing a video, or downloading a recurring report. The user opens Plugins, selects Record a skill, gives Codex context, approves recording, performs the workflow, stops the recording, and then reviews or refines the generated skill.

There are important availability and governance caveats. Codex Record and Replay is available on macOS, requires Computer Use to be available and enabled, and initially excludes the European Economic Area, the United Kingdom, and Switzerland. OpenAI also tells users to keep the demonstration short and complete, identify variable inputs before recording, use realistic inputs without secrets, and refine the skill to capture hidden preferences, naming conventions, default fields, and decision points.

Why it matters for AI engineering teams

Codex Record and Replay is not just a convenience feature. It creates a new artifact in the agent stack: the demonstrated workflow skill. That artifact sits between a prompt and a full plugin. It is inspectable and editable, but it may still drive Computer Use, browser actions, connected plugins, or a combination of tools in a live user environment.

That matters because many organizations are currently stuck between two poor options. They either let individuals delegate sensitive workflows to agents with one-off prompts, or they require engineering teams to hard-code every useful process into scripts and internal tools. Codex Record and Replay creates a middle lane: a business user or engineer can show the happy path, while the generated skill becomes a reviewable operational object.

The resulting risk model is closer to workflow automation than normal chat. Teams need to know who recorded the skill, what screens or fields were visible, which inputs are allowed to change, what success criteria Codex should verify, and whether the workflow touches money, customer data, production systems, or external communication. The feature also makes regional policy visible: a workflow that works on one employee's Mac may not be available to another employee if Computer Use is disabled or if the user sits in a restricted region.

The router/operator angle

For router and gateway operators, Codex Record and Replay is a signal that agent traffic will become more procedural. A repeated skill can create predictable bursts of model calls, browser actions, tool invocations, and follow-up verification steps. That is different from a human typing a single request into a chat window.

The first routing decision is classification. Treat recorded workflow skills as their own workload class, not as generic assistant traffic. A skill that creates issues or files reports can usually tolerate a lower-cost model for extraction and formatting, but may require a stronger model or human approval for final decisions. A skill that operates in a browser session should route through stricter logging and approval paths than a pure code-review prompt.

The second decision is fallback. If a replayed workflow depends on Computer Use, browser actions, and connected plugins, a provider outage or rate limit can leave the task half-complete. Operators should separate model fallback from workflow recovery: model fallback can retry the reasoning step, while workflow recovery needs idempotency, checkpointing, and a clear rule for when the agent must stop and ask a human.

The third decision is accounting. Replayed skills may look small in the UI but consume many calls across multiple tools. Teams using an AI gateway should tag workflow runs, record the initiating user or team, and break down cost by skill rather than only by model. That makes it possible to decide whether a recorded workflow deserves promotion into a governed plugin, a deterministic script, or a standard operating procedure.

What TheRouter users should watch or try

The practical test for Codex Record and Replay is not whether it can repeat a demo once. It is whether the resulting workflow can be governed as a repeatable route.

Use this checklist before letting a recorded workflow become routine:

  • Define the route class. Mark Codex Record and Replay skills separately from normal chat, code generation, and batch jobs in your routing layer.
  • Name variable inputs. Require the skill to list which fields can change on each run, such as file path, issue title, customer account, date range, or destination folder.
  • Separate execution from approval. Let the agent prepare a report, issue, or upload package, but require explicit approval before external submission, billing changes, customer messaging, or production mutation.
  • Add recovery points. If a browser page, plugin, or provider call fails, the skill should stop at a known checkpoint rather than improvising across a partially completed workflow.
  • Measure cost by skill. Use gateway logs and model usage reports to compare recorded workflows against manual scripts and managed plugins. The same model can be cheap for one-shot prompts and expensive for a multi-step replay.

Codex Record and Replay is early and region-limited, but the direction is clear: agent workflows are becoming reusable operational assets. The teams that win will not be the ones with the longest prompt library. They will be the ones that can route, approve, observe, and retire recorded workflows with the same discipline they already apply to API traffic and production automation.

Help & contact