# Computer Use Macos

> Top-level macOS computer-use skill with a bundled standalone runtime that bootstraps itself without any local Claude installation, private native modules, or extracted app assets.

- Skill: `lord1egypt/computer-use-macos` (Agent Skill)
- Install (CLI): `npx skillmds@latest add lord1egypt/computer-use-macos`
- Raw SKILL.md: https://api.skillmd.com/api/skills/lord1egypt/computer-use-macos/raw
- Safety review: pending (external: skill-scanner FAIL, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: Lord1Egypt (https://skillmd.com/u/lord1egypt)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/lord1egypt/computer-use-macos

---


# 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:

```bash
~/.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:

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

## Run

```bash
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.