💻 Intel Mac Compatible! ScPL and most actions work on both Intel and Apple Silicon Macs. Only Apple Intelligence actions (Use Model, Image Playground) require Apple Silicon.

🎉 macOS Tahoe Updates

This fork adds 22 new actions for macOS Tahoe, including:

🤖 Apple Intelligence (Apple Silicon only)

• Use Model (askllm) - AI integration with Apple Intelligence, on-device models, and ChatGPT
• Image Playground - Generate images with AI (GenerateImageIntent)

🤖 AI Assistants (Intel & Apple Silicon)

• ChatGPT & Claude - Direct integration with AI assistants (requires apps installed)

⚙️ System & Scripting (Intel & Apple Silicon)

• Shell script execution (runshellscript, runapplescript, runjavascriptforautomation)
• File operations (file.rename, file.move, file.reveal, and more)
• System utilities (getonscreencontent, connecttoservers)

→ See MACOS_TAHOE_UPDATES.md for the complete list

→ Total: 294 actions (original: 272, +22 new)

📊 What is ScPL?

ScPL is a programming language for iOS/macOS Shortcuts that lets you write shortcuts in text instead of dragging and dropping blocks. Perfect for:

• ✨ Large shortcuts - Copy/paste actions, work without scrolling
• 🔧 Version control - Track changes with Git
• ⚡ Speed - Type actions faster than dragging
• 🔍 Debugging - See your entire shortcut at once

Example

ShowResult "Hello ScPL"
ChooseFromMenu prompt="ScPL" items=["Getting Started", "View Documentation"]
Case "Getting Started"
    URL "https://docs.scpl.dev/gettingstarted"
Case "View Documentation"
    URL "https://docs.scpl.dev/"
End Menu
OpenURLs

→ Use the command-line tool or see the original ScPL Editor (by pfgithub)

🛠️ Tools for Working with Shortcuts

Extract Action Identifiers with Shortcut Source Tool

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

How to Extract Action Identifiers

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:

   • See CONTRIBUTING.md for how to add actions
   • Submit a PR with your action definition

Example JSON output:

{
  "WFWorkflowActionIdentifier": "is.workflow.actions.askllm",
  "WFWorkflowActionParameters": {
    "WFLLMModel": "Apple Intelligence",
    "WFLLMPrompt": "Summarize this article"
  }
}

🚀 Quick Start

Installation

npm install -g scpl

Usage

# Install
npm install -g scpl-macos-updated

# Convert ScPL to .shortcut file
scpl-macos-updated input.scpl output.shortcut

# Or if you alias it:
scpl input.scpl output.shortcut

Documentation

• 📚 Original ScPL Documentation (by pfgithub)
• 📖 macOS Tahoe Actions Reference
• 🤝 Contributing Guide

🤝 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. See CONTRIBUTING.md for:

• 📝 How to extract action identifiers with Shortcut Source Tool
• 🔧 How to create action definitions
• 🚀 How to submit a PR

Popular Apps We'd Love to See

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?

🍎 Apple Intelligence Actions (Apple Silicon M1+ required)

• is.workflow.actions.askllm - Use Model (AI prompts)
• com.apple.GenerativePlaygroundApp.GenerateImageIntent - Image Playground

🤖 AI Assistant Integrations (Intel & Apple Silicon)

• com.openai.chat.OpenVoiceModeIntent - ChatGPT Voice Mode
• com.anthropic.claude.ClaudeAppIntentsExtension - Ask Claude

🔧 Shell & Scripting (3 actions - Intel & Apple Silicon)

• runshellscript, runapplescript, runjavascriptforautomation

📁 File Operations (10 actions - Intel & Apple Silicon)

• file, file.rename, file.move, file.reveal, file.select
• file.label, file.getfoldercontents, finder.getselectedfiles, savefile

🌐 System & Network (5 actions - Intel & Apple Silicon)

• connecttoservers, getonscreencontent, makespokenaudiofromtext
• converttimezone, text.trimwhitespace, output, setname

→ See MACOS_TAHOE_UPDATES.md for detailed documentation

🔗 Useful Links

| Resource | Description | |----------|-------------| | ScPL Editor | Convert shortcuts to ScPL online | | ScPL CLI | Command-line converter | | RoutineHub | Shortcut sharing community | | Shortcut Source Tool | Developer tools for shortcuts | | r/shortcuts | Reddit community |

💻 Development

Setup

git clone https://github.com/cavingraves/scpl-macos-updated.git
cd scpl-macos-updated
yarn install

Running Tests

yarn test

Before Submitting PR

yarn prepublishOnly

This will format code with Prettier and run tests.

📄 License

MIT License - Same as original scpl

🙏 Credits

• Original scpl: pfgithub/scpl
• macOS Tahoe Updates: Extracted from real shortcuts and community resources
• 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).