Macos Automation
Apps & Automationmacos-automationMacos Automation is an Agent Skill for apps & automation published in the vellum-ai/vellum-assistant repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Automate native macOS apps and system interactions via osascript (AppleScript)
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/vellum-ai/vellum-assistant/blob/HEAD/skills/macos-automation/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/macos-automation, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
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 "[email protected]"'
# 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