| name | codex-computer-use |
| description | Control local apps through Computer Use (the @oai/sky runtime) inside the Codex app. Use when the session uses a custom (non-OpenAI) model, for example deepseek-v4-flash or mimo-v2.5, and the user asks to control the computer, operate a desktop app's UI, use Safari or Chrome through computer use, click or type in an app, or take a screenshot of an app. Prefer purpose-built connectors, APIs, or CLIs when they exist. |
Codex Computer Use
The runtime is @oai/sky, imported through mcp__node_repl__js (available
in this session).
First: read the official skill
The official skill is authoritative. Read it before any computer-use work:
~/.codex/plugins/cache/openai-bundled/computer-use/<version>/skills/computer-use/SKILL.md
Find the latest <version> directory.
Load the runtime (once per session)
Send this as ONE line through mcp__node_repl__js:
globalThis.sky = (await import("@oai/sky")).sky;
nodeRepl.write("sky: " + typeof sky);
Confirm the output says sky: object before continuing. The import
connects to the SkyComputerUseService, which is already running.
Rules
- Send code as ONE line, or use
@file:<path> with a trailing newline.
The runtime fires on newline; input without a trailing newline silently
does nothing.
- Reuse the loaded
sky runtime on later turns. Do not reinitialize.
- The first computer-use action may need approval in the app
(Settings → Computer use). Common apps such as Safari and Chrome are
usually pre-approved.
- Prefer purpose-built connectors, APIs, and CLIs over computer use when
they exist. Computer use is for reading or operating app UI that nothing
else can reach.
- Never start your own node_repl process and never write a side-channel
driver. Use the tool you were given.
If the tool is missing
Stop and report that mcp__node_repl__js is not in the tool list. Do not
build workarounds.
