mac-computer-use skillB

mac-computer-use is agent-read markdown (skill) from to3akarin/mac-computer-use: 操作 macOS 桌面应用,探测窗口和自动化接口、截图、读取或修改辅助功能元素、执行鼠标键盘动作,以及通过 CDP 操作内嵌 Chromium 页面。适用于桌面应用自动化与界面验收;普通网页任务优先使用已有浏览器工具。.

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

# Mac Computer Use

本技能使用本目录中的独立工具,不需要专属 MCP 插件。所有相对路径均以本文件所在目录为基准;Agent 的当前目录可能是其他项目,执行时先解析技能根目录并使用绝对路径。

## 通用入口

本目录遵循开放的 Agent Skills 格式。使用 runtime 提供的文件读取、本机命令执行和图片查看能力;`agents/openai.yaml` 是可选界面元数据,不参与核心运行。

先从 runtime 告知的 `SKILL.md` 路径确定技能根目录。下文的 `SKILL_DIR` 是你据此设置的局部 shell 变量,不是任何客户端的内置环境变量。

```bash
sh "$SKILL_DIR/scripts/run.sh" native doctor
sh "$SKILL_DIR/scripts/run.sh" native windows
sh "$SKILL_DIR/scripts/run.sh" cdp targets --endpoint http://127.0.0.1:9222
```

统一入口准备原生构建或检查 Node.js,保持当前工作目录,原样传递参数、JSON 和退出码。构建日志写入标准错误。首次原生调用需要编译;不要把正常编译等待误判为工具失联。仅支持远端 Linux 沙箱的 runtime 不能直接操作宿主 Mac,需要在具备本机命令能力的执行环境运行。

安装和 runtime 接入方式见 [跨 runtime 使用](references/runtimes.md)。

## 开始前

1. 通过统一入口运行 `native doctor` 检查平台与权限。Node.js 仅用于 CDP;每次更换承载工具的宿主应用后重新检查权限。
2. 明确目标应用、窗口与用户要得到的结果。已有授权继续有效;无需把每个可逆操作拆成审批。
3. 先 `probe` 和观察。优先应用已有 CLI、脚本字典或接口,其次 AX,再考虑鼠标键盘。发现端口只代表候选,必须验证协议及目标。
4. 原生命令见 [原生控制](references/native.md);内嵌 Chromium 控制见 [CDP](references/cdp.md)。参数以工具帮助和这些文档为准,不猜测。

## 操作循环

观察目标 → 选定元素或坐标 → 写操作预演 → 执行一次 → 读回目标状态 → 判断完成或重新观察。

- 读窗口和 AX 不激活应用。截图失败不自动将另一个窗口当成目标。
- AX 引用与窗口快照有时效。窗口移动、调整大小或内容重建后重新观察;坐标单位必须显式指定。
- 只有用户空闲且窗口位于当前桌面时才可借用前台;不自行切换桌面。操作期间用户恢复输入时停止,不与用户争抢焦点。
…

Read the whole file at its exact version.

How to install

Latest version
mdr add to3akarin/mac-computer-use/mac-computer-use@v0.2.0
Exact content
mdr add to3akarin/mac-computer-use/mac-computer-use@sha256:b058058c3fed84f0

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_xmgant66hqh3332g.svg)](https://markdownregistry.com/a/art_xmgant66hqh3332g)

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
v0.2.0 latest2026-09-09 f035184 4,262 BB view · diff
git:20260908.40149ed2026-09-08 40149ed 2,908 BA view

Audit of the latest version

B  16 of 17 checks passed. Deterministic, no model, same answer every run.
  • fail: No link to a raw IP address (matched: http://127.0.0.1:9222)
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (4262 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No script tag

Source

GitHub

to3akarin/mac-computer-use · 1,038 stars · license MIT · pushed 2026-09-24 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_xmgant66hqh3332g
GET https://markdownregistry.com/api/v1/resolve?ref=to3akarin/mac-computer-use/mac-computer-use
GET https://markdownregistry.com/api/v1/blob/b058058c3fed84f01124fb357a1fea3834b4086315d25a7122925fda820640ed

Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

More from to3akarin/mac-computer-use

DESIGN.md design
to3akarin/mac-computer-use · DESIGN.md
git:20260924.e381ebc · audit A · 1,038 stars

Every file in to3akarin/mac-computer-use

Browse by kind, by grade B, or by owner.