duolahypercho/codex-router · Archived

codex-computer-use

Control local apps through Computer Use (the @oai/sky runtime) inside the Codex app.

Installation

$ npx skills add duolahypercho/codex-router --skill codex-computer-use

Summary

  • 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.

Stronger alternatives

This repository is archived — consider an actively maintained alternative.

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 3.0K
License LICENSE
Default branch main
Open issues 5
Status Archived

Skill metadata

Parsed from SKILL.md frontmatter.

Declared agents codex

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 1,950 B
  • docs SUMMARY.md 444 B

History

  1. First recorded snapshot · 1 installs

SKILL.md

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.