cherri

README

Cherri

Cherri (pronounced cherry) is a Shortcuts programming language that compiles directly to a valid runnable Shortcut.

The primary goal is to make it practical to create large Shortcut projects (within the limitations of Shortcuts) and maintain them long term.

🌟 Top Features

• 🖥️ Laptop/Desktop-based development (CLI, VSCode extension, macOS app)
• 🎓 Easy to learn and syntax similar to other languages
• 🐞 1-1 translation to Shortcut actions as much as possible to make debugging easier
• 🥾 Half-bootstrapped: Most actions and types are written in the language.
• 🪄 No magic variables syntax, they're constants instead
• 🪶 Optimized to create as small as possible Shortcuts and reduce memory usage at runtime
• #️⃣ Include files within others for large Shortcut projects
• 🔧 Define actions with type checking, enums, optionals, default values, raw identifiers, and raw keys.
• 🔄 Define functions to run within their own scope at the top of your Shortcut to reduce duplicate actions.
• 📋 Copy-paste actions automatically
• 🥩 Enter action identifier and parameters manually using Raw Actions.
• ❓ Define import questions
• 📇 Generate VCards for menus
• 📄 Embed files in base64
• 🔀 Convert Shortcuts from an iCloud link with the --import= option
• 🔢 Type system and type inference
• 🔏 Signs using macOS, falls back on HubSign or another server that uses scaxyz/shortcut-signing-server.

Resources

• 🍒 Cherri VSCode Extension
• 🛝 Playground - Try out Cherri on any platform, preview the result, and export signed Shortcuts
• 🖥️ macOS IDE - Defines Cherri file type, write and build Shortcuts on Mac with a GUI
• 📄 Documentation - Learn Cherri or how to contribute
• 🔍 Glyph Search - Search glyphs you can use in Cherri!
• ❓ FAQ

Installation

You can install Cherri by downloading the latest release or via the Homebrew package manager:

Add Tap:

brew tap electrikmilk/cherri

Install:

brew install electrikmilk/cherri/cherri

Usage

cherri file.cherri

Run cherri without any arguments to see all options and usage. For development, use the --debug (or -d) option to print stack traces, debug information, and output a .plist file.

Why another Shortcuts language?

Because it's fun :)

Some languages have been abandoned, don't work well, or no longer work. I don't want Shortcuts languages to die. There should be more, not less.

Plus, some stability comes with this project being on macOS and not iOS, and I'm not aware of another Shortcuts language with macOS as its platform other than Buttermilk.

Community

• VS Code Syntax Highlighting (repo)

Credits

Reference

• zachary7829/Shortcuts File Format Documentation
• sebj/iOS-Shortcuts-Reference
• [Tip] Reducing memory usage of repeat loops

Inspiration

• Go syntax
• Ruby syntax
• ScPL
• Buttermilk
• Jelly

---

The original Workflow app assigned a code name to each release. Cherri is named after the second-to-last update "Cherries" (also cherry is one of my favorite flavors).

This project started on October 5, 2022.