applescript-reference

Use when writing AppleScript or JXA scripts, looking up app dictionary patterns, understanding scripting syntax, or setting up the applescript-mcp raw execution bridge.

Model	Source
inherit	pack: macos-automation

Full Reference

AppleScript Reference

Mandatory Announcement — FIRST OUTPUT before anything else:

┏━ 🔧 applescript-reference ━━━━━━━━━━━━━━━━━━━━━━┓
┃ [one-line description of what you're looking up] ┃
┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛

Comprehensive AppleScript and JXA (JavaScript for Automation) language reference for macOS scripting. Covers core language syntax, ObjC bridge, app-specific dictionary patterns for 15+ apps, and the applescript-mcp raw execution bridge. macOS built-in — no install needed for scripts.

Quick Reference

Item	Value
AppleScript	Built into macOS since System 7
JXA	Built into macOS since Yosemite (10.10)
Runtime	`osascript` CLI or Script Editor.app
applescript-mcp	v0.1.3 — raw osascript MCP bridge
applescript-mcp Install	`npx @peakmojo/applescript-mcp`
Fork	https://github.com/Armadillo-Nation/armadillo-mac-osascript

Reference Index

I want to…	File
Write AppleScript — tell blocks, handlers, variables, error handling, loops	`reference/applescript-core.md`
Write JXA — ObjC bridge, JSON, HTTP, files, clipboard, UI automation	`reference/jxa.md`
Automate specific apps — Safari, Chrome, Mail, Calendar, Finder, etc.	`reference/app-dictionaries.md`
Run raw scripts via applescript-mcp — setup, SSH, security	`reference/applescript-mcp.md`

Load only the reference docs relevant to the current task.