Mac Computer Use
To3akaRin/mac-computer-use
操作 macOS 桌面应用，探测窗口和自动化接口、截图、读取或修改辅助功能元素、执行鼠标键盘动作，以及通过 CDP 操作内嵌 Chromium 页面。适用于桌面应用自动化与界面验收；普通网页任务优先使用已有浏览器工具。
Automate native macOS apps and system interactions via osascript (AppleScript)
Install macOS Automation
$ npx skills add vellum-ai/vellum-assistant --skill macos-automation -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install vellum-ai/vellum-assistant macos-automation --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/vellum-ai/vellum-assistant.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/macos-automation .claude/skills/macos-automation && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "macos-automation" agent skill from https://github.com/vellum-ai/vellum-assistant/tree/main/skills/macos-automation into .claude/skills/macos-automation/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "macos-automation", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/vellum-ai/vellum-assistant/tree/main/skills/macos-automationType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add vellum-ai/vellum-assistant --skill macos-automation -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install vellum-ai/vellum-assistant macos-automation --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/vellum-ai/vellum-assistant.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/macos-automation .agents/skills/macos-automation && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "macos-automation" agent skill from https://github.com/vellum-ai/vellum-assistant/tree/main/skills/macos-automation into .agents/skills/macos-automation/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "macos-automation", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add vellum-ai/vellum-assistant --skill macos-automation -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install vellum-ai/vellum-assistant macos-automation --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/vellum-ai/vellum-assistant.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/macos-automation .cursor/skills/macos-automation && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "macos-automation" agent skill from https://github.com/vellum-ai/vellum-assistant/tree/main/skills/macos-automation into .cursor/skills/macos-automation/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "macos-automation", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/vellum-ai/vellum-assistant.git --path skills/macos-automation--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add vellum-ai/vellum-assistant --skill macos-automation -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install vellum-ai/vellum-assistant macos-automation --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/vellum-ai/vellum-assistant.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/macos-automation .gemini/skills/macos-automation && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "macos-automation" agent skill from https://github.com/vellum-ai/vellum-assistant/tree/main/skills/macos-automation into .gemini/skills/macos-automation/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "macos-automation", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install vellum-ai/vellum-assistant macos-automationInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add vellum-ai/vellum-assistant --skill macos-automation -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/vellum-ai/vellum-assistant.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/macos-automation .github/skills/macos-automation && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "macos-automation" agent skill from https://github.com/vellum-ai/vellum-assistant/tree/main/skills/macos-automation into .github/skills/macos-automation/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "macos-automation", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add vellum-ai/vellum-assistant --skill macos-automation -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install vellum-ai/vellum-assistant macos-automation --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/vellum-ai/vellum-assistant.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/macos-automation .opencode/skills/macos-automation && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "macos-automation" agent skill from https://github.com/vellum-ai/vellum-assistant/tree/main/skills/macos-automation into .opencode/skills/macos-automation/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "macos-automation", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
macos-automation- GitHub stars
- 1.4k
- Token cost
- ~778 tokens
- SKILL.md length
- 168 words
- Files
- 2 (incl. assets)
- Skills in repo
- 108
- Repo updated
- First seen
- Licence
- MIT
At a glance
Automate native macOS apps and system interactions via osascript (AppleScript)
- Tasks that involve Desktop control
- SKILL.md covers Supported Apps, Examples and Tips
- Calls osascript
What it does
macOS Automation is an agent skill from vellum-ai/vellum-assistant. Automate native macOS apps and system interactions via osascript (AppleScript)
Its SKILL.md is about 780 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including assets. Compatibility notes: Designed for Vellum personal assistants
It sits in Productivity & Automation, covering Desktop control. It works with macOS. The repository describes itself as: An AI Assistant that’s easy to setup, does your work 24/7, knows your preferences and gets better over time. The licence is MIT.
When your agent uses it
- Tasks that involve Desktop control
Example prompts
- “/macos-automation”
Requirements
- Compatibility (from SKILL.md): Designed for Vellum personal assistants
What it can do on your machine
Read from SKILL.md and the folder at commit 33cc983. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
osascript
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Compatibility
Designed for Vellum personal assistants
From compatibility in the SKILL.md frontmatter.
Context cost
macOS Automation loads about 778 tokens when it runs. Until then it costs about 24 tokens; SKILL.md has 168 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from vellum-ai/vellum-assistant at commit 33cc983, republished under its MIT licence (© vellum-ai). 168 words, ~778 tokens.
Download SKILL.mdSave it as
.claude/skills/macos-automation/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.- name
- macos-automation
- description
- Automate native macOS apps and system interactions via osascript (AppleScript)
- compatibility
- Designed for Vellum personal assistants
- metadata.icon
- assets/icon.svg
- metadata.emoji
- 🍎
Use this skill to interact with native macOS apps and system-level features via osascript (AppleScript) through host_bash. Always prefer osascript over browser automation or computer-use for anything involving a native macOS app.
Supported Apps
Communication: Messages, Mail, Microsoft Outlook, FaceTime Contacts & Calendar: Contacts, Calendar, Reminders Notes & Writing: Notes, TextEdit, Pages, BBEdit, CotEditor Files: Finder, Path Finder Browsers: Safari, Google Chrome Music & Media: Music (iTunes), Spotify, VLC, Podcasts, TV Productivity: OmniFocus, Things 3, OmniOutliner, OmniPlan, OmniGraffle Office: Microsoft Word, Microsoft Excel, Numbers, Keynote Developer tools: Xcode, Terminal, iTerm2, Script Editor System: System Events (UI scripting for any app), System Settings Automation: Keyboard Maestro, Alfred, Automator Creative: Adobe Photoshop, Final Cut Pro
For any unlisted app, check scriptability first:
osascript -e 'tell application "AppName" to get name'Examples
# Send an iMessage
osascript -e 'tell application "Messages" to send "Hello!" to buddy "user@example.com"'
# Look up a contact
osascript -e 'tell application "Contacts" to get {name, phones} of every person whose name contains "Marina"'
# Read upcoming calendar events
osascript -e 'tell application "Calendar" to get summary of every event of calendar "Home" whose start date > (current date)'
# Create a reminder
osascript -e 'tell application "Reminders" to make new reminder with properties {name:"Buy milk", due date:((current date) + 1 * hours)}'
# Send an email
osascript -e 'tell application "Mail" to send (make new outgoing message with properties {subject:"Hi", content:"Hello", visible:true})'
# Create a note
osascript -e 'tell application "Notes" to make new note at folder "Notes" with properties {body:"My note"}'
# Open a URL in Safari
osascript -e 'tell application "Safari" to open location "https://example.com"'
# Play/pause Music
osascript -e 'tell application "Music" to playpause'
# Display a system notification
osascript -e 'display notification "Done!" with title "Vellum"'Tips
- For multi-line scripts, write them to a
.applescriptfile and run withosascript path/to/script.applescript - Use
System Eventsfor UI scripting apps that don't have their own AppleScript dictionary - AppleScript permissions are gated by macOS TCC - if a command fails with a permission error, use
request_system_permissionto prompt the user
© vellum-ai, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 1 other file (assets) in skills/macos-automation of vellum-ai/vellum-assistant.
- SKILL.md
- assets/icon.svg
Open the folder on GitHubat commit 33cc983
Compare with similar skills
macOS Automation next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| macOS Automation this skillvellum-ai/vellum-assistant | 1.4k | — | ~778 | Automated safety check: Pass | MIT | |
| Mac Computer UseTo3akaRin/mac-computer-use | 1.1k | — | ~495 | Automated safety check: Pass | MIT | |
| Verify Reelrselbach/reel | 118 | — | ~2k | Automated safety check: Pass | Unlicense | |
| Steerdisler/mac-mini-agent | 272 | — | ~2.1k | Automated safety check: Pass | None | |
| Computer Usekunpengtalk/PeakCode | 166 | — | ~2.5k | Automated safety check: Pass | MIT | |
| Openbridge DebugAFK-surf/OpenBridge | 430 | — | ~2.2k | Automated safety check: Pass | MIT |
Similar skills
Verify Reel
rselbach/reel
Verify Reel, the macOS menu-bar screen recorder, by launching a disposable app bundle and driving its real UI with Computer Use.
Steer
disler/mac-mini-agent
macOS GUI automation CLI. An agent skill from disler/mac-mini-agent.
Computer Use
kunpengtalk/PeakCode
Drive a macOS app through the computer tool — read its accessibility tree, act on elements, and use real input only when the tree cannot reach the target.
Openbridge Debug
AFK-surf/OpenBridge
Debug and validate OpenBridge on a real macOS desktop through mini-machine plus full VNC computer-use.
Computer Use
clacky-ai/openclacky
Drive the desktop — macOS, or the Windows desktop through WSL — when a task needs a native app, dialog, menu bar, file picker or anything the terminal and browser tools cannot reach.
More from vellum-ai/vellum-assistant
All 108 skills in this repoVellum GitHub App Setup
vellum-ai/vellum-assistant
Create and configure a GitHub App so the assistant can push commits, open PRs, and comment under its own bot identity.
Discord App Setup
vellum-ai/vellum-assistant
Connect a Discord bot to the assistant via the Discord Gateway with guided application creation and intent configuration
Sentry App Setup
vellum-ai/vellum-assistant
Create and configure a Sentry internal integration so the assistant can manage issues, alerts, and releases under its own identity
Memory Corpus Ingest
vellum-ai/vellum-assistant
Ingest a large dataset into memory as a skimmed map. An agent skill from vellum-ai/vellum-assistant.
Plugin Builder
vellum-ai/vellum-assistant
A skill your agent uses when the user wants to build, scaffold, ship, or edit a Vellum plugin that bundles multiple surfaces (hooks, tools, skills, and more) into one installable package.
Slack App Setup
vellum-ai/vellum-assistant
Connect a Slack app to the Vellum Assistant via Socket Mode.
Related
Works with
Categories
Questions about macOS Automation
What does macOS Automation do?
Automate native macOS apps and system interactions via osascript (AppleScript). macOS Automation is an agent skill from vellum-ai/vellum-assistant.
When should I use macOS Automation?
macOS Automation fits situations like: tasks that involve Desktop control.
How do I install macOS Automation in Claude Code?
Run `npx skills add vellum-ai/vellum-assistant --skill macos-automation -a claude-code`. Or copy the skill folder (skills/macos-automation in vellum-ai/vellum-assistant) into .claude/skills/macos-automation in your project. Claude Code loads it when a task matches its description.
How do I install macOS Automation in Codex?
Run `npx skills add vellum-ai/vellum-assistant --skill macos-automation -a codex`. Or copy the skill folder (skills/macos-automation in vellum-ai/vellum-assistant) into .agents/skills/macos-automation in your project. Codex loads it when a task matches its description.
Can I use macOS Automation in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add vellum-ai/vellum-assistant --skill macos-automation -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/macos-automation, .gemini/skills/macos-automation, .github/skills/macos-automation and .opencode/skills/macos-automation in your project.
What does macOS Automation need to run?
Going by SKILL.md and its folder, macOS Automation needs the command-line tools its instructions call (osascript). Compatibility (from SKILL.md): Designed for Vellum personal assistants.
Does macOS Automation access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is macOS Automation safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does macOS Automation use?
macOS Automation is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does macOS Automation use?
About 778 tokens (SKILL.md is roughly 3.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to macOS Automation?
Skills that share tags, products or a category with macOS Automation: Mac Computer Use (To3akaRin/mac-computer-use, 1.1k stars), Verify Reel (rselbach/reel, 118 stars), Steer (disler/mac-mini-agent, 272 stars) and Computer Use (kunpengtalk/PeakCode, 166 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains macOS Automation?
vellum-ai (a GitHub organization) maintains it in vellum-ai/vellum-assistant, which has 1,408 GitHub stars. The repository holds 108 skills in this directory. The repository was last updated on October 9, 2026.
Source: vellum-ai/vellum-assistant on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.