Repository navigation
feat(drivers): codex-computer-use, OpenAI's Codex Computer Use as a macOS driver (FD-5356) - #550
Merged
earakely-scale merged 5 commits intoNov 9, 2026
Conversation
…acOS driver (FD-5356) The ChatGPT app's unified-computer-use plugin as a computer driver on macOS. ChatGPT 26.930.51102, OpenAI's versioned download pinned by sha256, is unpacked beside the driver and never run; its helper app is copied to a fixed path and granted Accessibility, Post Event and Screen Recording. The driver starts the plugin's cua_repl as the app would, one server per agent session, and forwards its js and js_reset, hiding the two tools it serves only the ChatGPT app. It answers Codex's per-app approvals from the allowed_apps setting, by name or bundle identifier (every app when unset, audio recording never), and runs each call under Codex's managed read-only sandbox unless js_sandbox is off. No ChatGPT sign-in is needed. computer/v1 is MacOSDriver's. On a Mac host with lume, it composes onto macos-26 and passes gate 3's full probe (53 passed, 1 not applicable); a verifier driving the deployed driver over MCP opened Calculator, computed 7 x 6 = 42, was refused TextEdit, which allowed_apps didn't name, and took a computer/v1 screenshot. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…s read-only Nothing tells the driver when an agent session ends, so each session's cua_repl stayed open for the driver's life: a REPL left unused for 30 minutes is now closed by a sweep, and past eight the least recently used is closed when a new one starts, never one in a call, so active sessions keep their bindings. js keeps the schema and description Codex serves, but its hints say it changes apps and reaches the world (readOnlyHint false, destructiveHint and openWorldHint true), where Codex marks it read-only. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…-use REPL Closing other sessions' REPLs awaited between finding the caller's REPL and putting it back, so a second call from the same session made a REPL of its own and the first call then replaced it. Eviction now takes REPLs out at once and closes them in the background, so nothing awaits before a call is queued. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…data and checks its pins agree - Approvals take the app's bundle identifier and name from the request's metadata, and the name its message quotes only beside them, so a reworded message no longer declines every app; a request that names no app is a warning. - computer-ready compares cua_repl's instructions and every field mcp.json pins for its tools, not only their input schemas. - The app's paths are relative to APP, install.sh names the helper's folder once, the README no longer repeats the version, and a unit test checks that env.toml, install.sh and driver.py agree on the version and the helper's path. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…arts a new one A stopped server was still ending when the session's next call came, so the call joined its queue and failed with the error it ended on, as on Linux CI. Each server now has its own queue, let go as soon as it takes no more calls, so the next call starts a server afresh; close ends every server still ending. The test slows the old server's end so the next call always arrives meanwhile. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
earakely-scale
deleted the
edgararakelyan/fd-5356-cu2-codex-computer-use-driver
branch
November 9, 2026 06:22
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
OpenAI's Codex Computer Use becomes a computer driver on macOS:
codex-computer-use, in the drivers bundle beside agent-desktop and macos-harness. It's the ChatGPT app'sunified-computer-useplugin. The plugin's MCP server,cua_repl, runs the JavaScript an agent sends against OpenAI'scuaAPI, which reads apps' accessibility trees and acts on them in the background through the plugin's helper app.Install (
[install.macos]). ChatGPT 26.930.51102 is fetched from OpenAI's versioned URL (persistent.oaistatic.com/codex-app-prod/ChatGPT-darwin-arm64-<version>.zip), checked by sha256.install.shunpacks it beside the driver and never runs it, so it never updates itself./opt/agentenv/codex-computer-use/. That path doesn't depend on the driver folder's name, so the layer's grant can name it.One
cua_replper agent session. The driver startscua_replas the app would, on the app's own Node with the environment the app builds, with only the computer surface on. Each agent session gets its own server, since the REPL keeps its bindings between calls. A server that stops is started afresh on the next call. Nothing says when a session ends, so a server unused for 30 minutes, or past the eight kept, is closed, the least recently used first.Tools. Agents get the server's instructions and its
jsandjs_reset, pinned inmcp.json.js_add_node_module_dirandturn_ended, which it serves only the ChatGPT app, are hidden. Thecomputer_*tools come fromMacOSDriver.Approvals. Codex asks its host before each action on an app, as an MCP elicitation. The driver answers each one:
allowed_appssetting names, by name or bundle identifier, case-insensitively, as the request's metadata gives them (the message's quoted name too, but a reworded message doesn't decline every app);Sandbox. Each call carries Codex's managed read-only sandbox, unless
js_sandbox = false:~/.codexand the temp folders are writable;The apps it drives are outside the sandbox, so Computer Use still works. Reads and commands still run, so a bench that wants GUI-only use needs its own guard.
No ChatGPT sign-in. It ran without one, and we chose to run it that way. Whether running Computer Use without a ChatGPT Work or Codex sign-in fits OpenAI's terms is an open question.
computer-readychecks:cua_replgives the instructions and lists the toolsmcp.jsonpins, every field it pins;cua.getState();Testing
Unit:
tst/unit/drivers/codex_computer_use_driver_test.py, 10 tests, 9 of them against a fakecua_replthat sends approval requests shaped like Codex's real ones. They cover:_meta;cua_repl's environment;env.toml,install.shanddriver.pyagree on the pinned version and the helper's path.The env, bundle and drivers suites pass locally, apart from three tests that fail the same way on
mainon macOS: two incua_driver_test.py, and the Windows ISO test intest_disk_recipe.py.ruff check .is clean.On an EC2 Mac host with lume, through
agent-env run:macos-26in 4 min 6 s.deploy_envwithallowed_apps = ["Calculator"]passed the driver's readiness checks.env_outcome_verifierdriving the deployed driver over MCP, as an agent would, passed all 5 checks:jsandjs_resetof Codex's tools listed;js;computer/v1screenshot.Docs
The site's computers or drivers page should gain
codex-computer-use:allowed_appsandjs_sandboxsettings, passed indeploy_env'sdriver_settings;jscan still read files and run commands, so a bench guards for GUI-only use.🤖 Generated with Claude Code


Confidence Score: 5/5
The PR appears safe to merge; no new blocking issue was found.Summary
Adds
codex-computer-useas a macOS driver with app approvals, sandbox settings, pinned downloads, and readiness checks.Reviews (10) · Last reviewed commit: "fix(drivers): a codex-computer-use call ..." · Reviewed by Greptile