macOS Computer-Use Skill

macOS Computer-Use Skill

Use this skill when the task needs a portable macOS computer-use skill bundled with its own standalone runtime and MCP server.

What this skill does

• uses the bundled macos-computer-use-skill project under the installed skill directory
• builds the standalone MCP server
• lets the server auto-bootstrap its Python runtime on first launch
• avoids any dependency on local Claude binaries, .node modules, or extracted app assets
• stays explicitly macOS-only because the underlying desktop-control backend is macOS-specific

Default bundled project path

After installation, assume the standalone project lives at:

~/.codex/skills/computer-use-macos/project

If the user installed the skill under a custom CODEX_HOME, use that equivalent path instead.

Build

Always build from the bundled project:

cd ~/.codex/skills/computer-use-macos/project
npm install
npm run build

Run

cd ~/.codex/skills/computer-use-macos/project
node dist/cli.js

The first real run will automatically create .runtime/venv and install the public Python dependencies.

Validation notes

• On real macOS hosts, prefer validating typing through the MCP type tool path, not only low-level helper calls.
• Version 0.2.2 routes ordinary macOS text input through clipboard paste when available, avoiding IME/input-source corruption seen with per-key typing under Chinese input methods.

Guardrails

• Treat this host as trusted-local only.
• Do not tell the user to search their local Claude install for binaries or hidden assets.
• Be explicit that this runtime is standalone and uses public dependencies only.
• Mention that the current runtime reports screenshotFiltering: none, so action gating is handled at the MCP layer.