Repository navigation
What's changed
Apple platform version 27 support
Cherri now targets version 27 by default.
- Added the
27platform version and made it the default client version. - Added automation triggers with a new
#triggerdirective, so a Shortcut can be configured to run on its own. Supported triggers arescreenshot,battery,stageManager,wifi,bluetooth,displayandcharging. Use more than one#triggerto fire from multiple different events. Automations must be enabled after import, and some additional settings are not embedded in the Shortcut data and must be manually set.#trigger wifi joined #trigger bluetooth connect alert("Connected")
- Added the new storage actions
storeValue(),getStoredValue()anddeleteStoredValue(). Content can be stored per Shortcut or globally. Unfortunately, at least currently, storage cannot be preset; you need to use something like:@value = getStoredValue("key") if !@value { setStoredValue("key", "default") @value = "default" }
- Updated the Use Model actions to
askModel()andaskProModel()to support the new Cloud Pro model option, plus the newallowSearchoption (use Broad World Knowledge).askDeviceModel()replacesaskDeviceLLM(). - Deprecated
askLLM()andaskCloudLLM(). They are now limited to versions below 27, since version 27 renamed the Cloud models.
Breaking changes
#include 'stdlib'is now#include 'stdfunc'. The stdlib file was renamed to avoid confusion with the actions standard library.- The default target version is now 27 instead of 26. Use
#define versionto target an earlier version. askLLM()andaskCloudLLM()are unavailable when targeting version 27 or later. UseaskModel()oraskProModel()instead.
Fixes and improvements
- Allowed a variable as the body of
fileRequest()(#199). - Fixed decompiling an empty custom separator (#195).
- Declared an output type for
rawAction()so its result can be used in conditions. - Selected ToolKit Tools columns by name (#233).
- Added the
paintbrushPointedglyph (#197). - Fixed inaccurate action indexes for import questions. Import Questions used after function headers, control flow, or variable assignments recorded the wrong index, and a question on the first action had its index omitted.
- Fixed the line number reported by errors being off by one, and the error column highlight being compared against the wrong cursor.
- Fixed cursor accuracy when parsing comma-separated lists.
- Adjusted the compiled Shortcut metadata to better match what Shortcuts produces, including default workflow types and sorted input content item classes. Added the
installedappinput type. - Fixed the
--no-ansiflag still producing highlight formatting in search results. - Updated the generated action documentation to show
!on literal-only parameters and to print version restriction notes in plain language.
New contributors
- @hcgatewood made their first contribution in #233
New repo AI agent skill
During this time, I've added a skill to the repo called shortcuts-sync. This tells the agent how to read the Shortcuts database and read the plist of Shortcuts, both on your Mac. If you have an iOS simulator installed through Device Hub via Xcode, it will also read that database for iOS-specific actions. I think this should benefit all contributions and reviews on the project and allow us to better verify the compiler output is accurate to what Shortcuts expects.
Other
- Cherri macOS app IDE has been updated to have better syntax highlighting specific to Cherri, a new Import option, fixed inline warnings and errors, and a slightly better Liquid Glass icon.
- Cherri Playground and Shortcut preview have been updated for version 27.
- Cherri iOS app on the App Store made by a contributor; see README.
Full changelog: v2.3.0...v2.4.0