Code your Apple Shortcuts in text! 495 actions for macOS automation. AI-powered creation with Claude. Text-based shortcut programming language. Vibe code your workflows instead of clicking. Supports Apple Intelligence, Voice Memos, Clock automation, Windo
npm install scpl-macos-updated

Code Your Apple Shortcuts ⢠Vibe-Based Automation ⢠AI-Powered Creation
Write macOS Shortcuts in text instead of clicking ⢠Natural language programming for Apple automation




> š“ Fork of pfgithub/scpl ā Updated for macOS Tahoe with 222 new actions, Apple Intelligence, and MCP server support
> š» Intel Mac Compatible! ScPL-macOS-updated and most actions work on both Intel and Apple Silicon Macs.
> Only Apple Intelligence actions (Use Model, Image Playground) require Apple Silicon.
š Find what you need: Apple Shortcuts automation ⢠Shortcuts scripting language ⢠Program shortcuts with code ⢠Text-based shortcut builder ⢠AI shortcut generator ⢠Automate macOS with Claude ⢠Vibe code your workflows ⢠Natural language automation ⢠Voice memo automation ⢠Dark mode scheduling ⢠Window manager shortcuts ⢠Pomodoro timer automation ⢠Accessibility automation ⢠HomeKit scripting
---
This fork adds 222 new actions including comprehensive coverage of Apple apps (Clock, Photos, Voice Memos, Books, Weather, Stocks, Freeform, Shortcuts management, Accessibility, and more), plus AI-powered shortcut creation with the MCP server!
askllm) - AI integration with Apple Intelligence, on-device models, and ChatGPTGenerateImageIntent)runshellscript, runapplescript, runjavascriptforautomation)file.rename, file.move, file.reveal, and more)getonscreencontent, connecttoservers)ā See MACOS_TAHOE_UPDATES.md for the complete list
ā Total: 493 actions (original scpl: 271, +222 new actions)
---
Tired of clicking through the Shortcuts app? ScPL-macOS-updated is a text-based programming language for Apple Shortcuts that lets you vibe code your automation instead of dragging blocks around.
Think of it as: Markdown for Shortcuts ⢠Code instead of clicks ⢠AI-powered shortcut generation
Perfect for:
- ⨠Large shortcuts - Copy/paste actions, work without scrolling like a pro
- š§ Version control - Track your automation in Git like real code
- ā” Speed - Type workflows 10x faster than GUI clicking
- š Debugging - See your entire shortcut logic at once
- š¤ AI creation - Describe shortcuts in plain English, get working code
- šÆ Power users - Build complex automations without RSI from clicking
``scplSimple notification shortcut
ShowResult "Hello from ScPL on macOS Tahoe!"
$3
Real automation workflow scenarios:
šÆ "I want to automate my morning routine"
ā Dark mode off, VPN on, start timer, open calendar, create voice memo for daily notes
ā±ļø "I need a Pomodoro timer with logging"
ā 25-min timer, log work sessions, auto dark mode during breaks
šø "Batch process screenshots with AI"
ā Take screenshot, AI extract text, save to organized folders, share via clipboard
š¤ "Voice memo workflow"
ā Record, auto-transcribe, tag with location/time, save to dated folders
šŖ "Window management layouts"
ā Arrange apps in specific positions, resize windows, switch between workspace configs
š¤ "AI-powered content creation"
ā Get clipboard, Claude/ChatGPT improve text, format output, copy back
š» "DevOps automation on Mac"
ā Git status check, run tests, open terminal, notify on completion
All of this in text you can copy/paste/share/version-control instead of clicking through menus!
---
š ļø Tools for Working with Shortcuts
$3
To contribute new actions or explore shortcuts, use these powerful tools:
#### Shortcut Source Tool š
The ultimate shortcut developer tool for viewing, editing, and analyzing shortcuts.
Features:
- š View Source - Export shortcuts as JSON or plist
- š§ Edit & Import - Modify shortcuts and import back to Shortcuts app
- š Web Review - Analyze shortcuts in your browser
- 𩹠Auto-Repair - Detects and fixes corrupted shortcuts
- š Copy/Paste Actions - Transfer actions between shortcuts
Required Dependencies:
- Shortcut Source Helper - Helper for reading/writing shortcut plists
- Tinycut Builder - Compiler that converts text to shortcuts
$3
1. Install the tools:
- Download Shortcut Source Tool
- Download Shortcut Source Helper
- Download Tinycut Builder
2. Run Shortcut Source Tool:
- Select your shortcut
- Choose "View Source"
- Select "JSON" format
3. Find action identifiers:
- Look for
"WFWorkflowActionIdentifier" keys
- Copy the identifier (e.g., "is.workflow.actions.askllm")
- Note the parameters under "WFWorkflowActionParameters"4. Submit to ScPL-macOS-updated:
- See CONTRIBUTING.md for how to add actions
- Submit a PR with your action definition
Example JSON output:
`json
{
"WFWorkflowActionIdentifier": "is.workflow.actions.askllm",
"WFWorkflowActionParameters": {
"WFLLMModel": "Apple Intelligence",
"WFLLMPrompt": "Summarize this article"
}
}
`---
š Quick Start
$3
`bash
npm install -g scpl
`$3
`bash
Install
npm install -g scpl-macos-updatedConvert ScPL to .shortcut file
scpl-macos-updated input.scpl output.shortcutOr if you alias it:
scpl input.scpl output.shortcut
`$3
Create shortcuts using natural language! One command installs everything:
For Claude Code (CLI):
`bash
npx scpl-updated-mcp-server --setup
`For Claude Desktop (GUI app):
`bash
npx scpl-updated-mcp-server --setup-desktop
`For OpenAI Codex:
`bash
npx scpl-updated-mcp-server --setup-codex
`For Codex forks (just-every/code, etc.):
`bash
npx scpl-updated-mcp-server --setup-codex=$CODE_HOME
`Multiple tools at once:
`bash
npx scpl-updated-mcp-server --setup --setup-desktop --setup-codex
`That's it! Restart your AI tool, then just ask:
> "Create a shortcut that gets clipboard text, asks ChatGPT to summarize it, and shows the result"
> "Make a shortcut that starts a 25-minute timer and creates a voice memo"
> "Build a shortcut that takes a screenshot and saves it to a dated folder"
Claude will write the ScPL code, validate it, and generate the
.shortcut file for you!ā See mcp-server/README.md for manual installation options
$3
- š macOS Tahoe Actions Reference - All 22 new actions
- š¤ MCP Server Guide - AI-powered shortcut creation
- š¤ Contributing Guide - Add your favorite app's actions
- š Original ScPL Documentation - Core language reference (by pfgithub)
---
š¤ Contributing
Want to add your favorite app's actions? We need your help!
Thousands of apps have App Intents that could be added to ScPL-macOS-updated. See CONTRIBUTING.md for:
- š How to extract action identifiers with Shortcut Source Tool
- š§ How to create action definitions
- š How to submit a PR
$3
Click to expand list
Productivity:
- Notion, Things 3, Bear, OmniFocus, Todoist
- DEVONthink, Obsidian, Craft
Creative:
- PDF Expert, Pixelmator Pro, Final Cut Pro
- Logic Pro, Adobe Creative Cloud
Development:
- Xcode, GitHub Desktop, Tower
- CodeRunner, Kaleidoscope
Communication:
- Slack, Discord, Microsoft Teams
- Telegram, Signal
Utilities:
- 1Password, Bitwarden
- Keyboard Maestro, Hazel, BetterTouchTool
---
š¦ What's New in This Fork?
$3
- is.workflow.actions.askllm - Use Model (AI prompts)
- com.apple.GenerativePlaygroundApp.GenerateImageIntent - Image Playground$3
- com.openai.chat.OpenVoiceModeIntent - ChatGPT Voice Mode
- com.anthropic.claude.ClaudeAppIntentsExtension - Ask Claude$3
- runshellscript, runapplescript, runjavascriptforautomation$3
- file, file.rename, file.move, file.reveal, file.select
- file.label, file.getfoldercontents, finder.getselectedfiles, savefile$3
- connecttoservers, getonscreencontent, makespokenaudiofromtext
- converttimezone, text.trimwhitespace, output, setnameā See MACOS_TAHOE_UPDATES.md for detailed documentation
---
š Useful Links
| Resource | Description |
|----------|-------------|
| npm Package | Install scpl-macos-updated |
| RoutineHub | Shortcut sharing community |
| Shortcut Source Tool | Developer tools for shortcuts |
| r/shortcuts | Reddit community |
| Original ScPL | Original scpl project by pfgithub |
---
š» Development
$3
`bash
git clone https://github.com/cavingraves/scpl-macos-updated.git
cd scpl-macos-updated
yarn install
`$3
`bash
yarn test
`$3
`bash
yarn prepublishOnly
``This will format code with Prettier and run tests.
---
MIT License - Same as original scpl
---
This project is a fork of ScPL (Shortcut Programming Language) by @pfgithub. The original project created the foundation for text-based shortcut programming that this fork builds upon.
Additional thanks to:
- Shortcut Source Tool: gluebyte on RoutineHub
- Action Discovery: xAlien95 for WFActions.plist analysis
- Shortcuts JS: Josh Farrant for glyph/color lists
---
Note: The original ScPL repository has not been updated since July 2021. This fork extends it with macOS-specific actions from Tahoe (macOS 26.x).
Made with ā¤ļø for the Shortcuts community