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:
CODEBLOCK0
If the user installed the skill under a custom CODEX_HOME, use that equivalent path instead.
Build
Always build from the bundled project:
CODEBLOCK1
Run
CODEBLOCK2
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.
macOS 电脑操作技能
当任务需要一个便携式、自带独立运行环境和MCP服务器的macOS电脑操作技能时,请使用此技能。
该技能的功能
- - 使用已安装技能目录下捆绑的 macos-computer-use-skill 项目
- 构建独立的MCP服务器
- 让服务器在首次启动时自动引导其Python运行环境
- 避免依赖本地的Claude二进制文件、.node 模块或提取的应用资源
- 明确仅适用于macOS,因为底层桌面控制后端是macOS专属的
默认捆绑项目路径
安装后,假设独立项目位于:
bash
~/.codex/skills/computer-use-macos/project
如果用户将技能安装在自定义的 CODEX_HOME 下,请使用相应的路径替代。
构建
始终从捆绑项目进行构建:
bash
cd ~/.codex/skills/computer-use-macos/project
npm install
npm run build
运行
bash
cd ~/.codex/skills/computer-use-macos/project
node dist/cli.js
首次实际运行将自动创建 .runtime/venv 并安装公共Python依赖。
验证说明
- - 在真实的macOS主机上,优先通过MCP的 type 工具路径验证输入,而非仅依赖底层辅助调用。
- 版本 0.2.2 在可用时通过剪贴板粘贴路由普通macOS文本输入,避免了在中文输入法下逐键输入时出现的IME/输入源损坏问题。
使用限制
- - 仅将此主机视为受信任的本地环境。
- 不要告知用户搜索其本地Claude安装中的二进制文件或隐藏资源。
- 明确说明此运行环境是独立的,仅使用公共依赖。
- 提及当前运行环境报告 screenshotFiltering: none,因此操作门控在MCP层处理。