@mcdp-adk/pi-codex-computer-use

pi extension: run cells in the Codex REPL to drive Windows desktop apps

Packages

Package details

extensionskill

Install @mcdp-adk/pi-codex-computer-use from npm and Pi will load the resources declared by the package manifest.

npm repo home report

$ pi install npm:@mcdp-adk/pi-codex-computer-use

Package: @mcdp-adk/pi-codex-computer-use
Version: 0.1.4
Published: Oct 15, 2026
Downloads: 534/mo · 22/wk
Author: mcdp2alh
License: MIT
Types: extension, skill
Size: 40.9 KB
Dependencies: 2 dependencies · 2 peers

Pi manifest JSON

{
  "skills": [
    "skills/codex-computer-use"
  ],
  "extensions": [
    "src/extension.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

pi-codex-computer-use

A pi package that lets pi drive Windows desktop apps through the computer-use runtime bundled with the Codex desktop app.

It talks to Codex's own node_repl MCP server, where the model writes JavaScript against @oai/sky, the same way Codex uses it.

Requirements

Windows
The Codex desktop app, installed locally and signed in once (so Codex writes its configuration)

This package ships no Codex files. It discovers and runs the Codex runtime already installed on your machine.

Install

pi install npm:@mcdp-adk/pi-codex-computer-use

Or install from the git repository, which follows main instead of releases:

pi install git:github.com/mcdp-adk/pi-codex-computer-use

The extension registers the computer_use / computer_use_reset tools, and the codex-computer-use skill becomes available to the model.

Use

The tools are not registered (with a single notice naming what is missing) until the Codex installation is complete; then the model can run cells in the Codex REPL. The model loads the codex-computer-use skill before its first cell; the skill points at the Codex guidance, confirmation policy, and sky API reference in the Codex installation, and lists where driving the runtime from pi differs from driving it inside Codex.

Tests

npm test

test/computer-use.test.ts and test/reset-abort.test.ts run against the real Codex runtime and require a signed Codex installation; they skip cleanly when one is not present.