NewYour coding agent can read the release notes before it upgrades.Set up the MCP server β
Go modules, #1167 by repository stars
Latest stable
v1.3.2
Last release 13 days ago
09 Nov 2026
Ships fairly regularly
a new release about every 3 weeks
Nearly every release is documented
notes for 9 of 10 stable releases
Nothing withdrawn
no release was ever pulled
4 years old
155 releases Β· first in 2023
Drag across the ruler to compare, or tap a release to open it.
@mst-mkt made their first contribution in https://github.com/electrikmilk/cherri/pull/74 (Thank you! This was an important fix for custom actions when
float type! (e.g. 0.5). Now distinguished from the integer type, which previously allowed decimals. This became necessary to fix the implementation of some actions! It uses the plist data type <real>.prompt().--output path by @NoelTautges in https://github.com/electrikmilk/cherri/pull/76splitText() and joinText().--action to search for raw action.setBrightness() with the new float type.Full Changelog: https://github.com/electrikmilk/cherri/compare/v0.2.4-beta...v0.2.5-beta
Thanks for using Cherri!
Your coding agent can read these notes before it upgrades. Set up the MCP server β
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Smaller release than normal while decompilation is being worked on to get some fixes and improvements in the meantime to the main branch out. Right no
Smaller release than normal while decompilation is being worked on to get some fixes and improvements in the meantime to the main branch out. Right now decomp is the top priority other than major bugs in the compiler preventing features from functioning properly.
getApps().setValue() action value argument valid type to variable to allow for any value, not just a string.Full Changelog: https://github.com/electrikmilk/cherri/compare/v0.2.3-beta...v0.2.4-beta
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
You can now use --glyph= to search for glyphs in the compiler. This will happen automatically if an invalid glyph identifier is used. The compiler wil
You can now use --glyph= to search for glyphs in the compiler. This will happen automatically if an invalid glyph identifier is used. The compiler will then compare the term you entered to the glyphs list and give you the closest glyphs to help you get to the glyph you meant to type.
<img alt="Playground Icon Editor" width="300" src="https://github.com/electrikmilk/cherri/assets/4368524/5ad1cfa4-4dcd-4bfa-8d3a-5ee34e6525d3"/>
You can now click on the rendered Shortcut icon in the playground to open a popover containing a mini version of the Shortcut glyphs search site. From there, you can visually pick the color and search for a glyph for your Shortcut icon. Switching the glyph or color will replace the identifier for the definition you're changing in your code in real-time.
The playground also now recognizes the name definition to display in the preview and what file to look for when compiling. This is now done before compilation to display the name in the preview.
It also now grabs the color and glyph defined to render the Shortcut icon rather than the preview rendering it. It will re-render in real-time the Shortcut icon if you change the color or glyph definition and the name under it.
getFolderContents() to not be recursive by default.-a= is no longer a shorthand for --action=.matchText().--debug option that contains the file after pre-processing (includes, etc.).Full Changelog: https://github.com/electrikmilk/cherri/compare/v0.2.2-beta...v0.2.3-beta
Nothing published for this version
Nothing published for this version
Nothing published for this version
An easier syntax than using getValue(dictionary, key) is now available. There may be more places where we need to fix this, but as far as I can tell t
An easier syntax than using getValue(dictionary, key) is now available. There may be more places where we need to fix this, but as far as I can tell this has been working, and dictionary key values can now be accessed using the following syntax:
@dictionary = {"test": 5}
@number = dictionary['test'] // 5
// this also works
@text = "{dictionary['test']}"
We have gotten permission from RoutineHub to sync glyphs with Jelly. This site allows you to search Shortcut glyphs. This may move to a new domain, but for now, this is at https://glyphs.cherrilang.org/.
<img src="https://github.com/electrikmilk/cherri/assets/4368524/2a8a31b7-c9eb-4061-a11c-6fb97971aa2e" width="300px" alt="Shortcuts Glyph Search"/>
open() -> openShortcut().--skip-sign for skipping signing manually.selectFolder() action by @electrikmilk in https://github.com/electrikmilk/cherri/pull/52.translate(text, to) argument to now being optional. This value should automatically be the set system language.Full Changelog: https://github.com/electrikmilk/cherri/compare/v0.2.1-beta...v0.2.2-beta
Nothing published for this version
Nothing published for this version
Fixes issue with the count() action.
count() action.Ask global, to not do a type check against it.Apologies for the small release, a lot of work is going on in decomp to achieve a full Shortcut to Cherri decompilation. It has been going better than I expected. The output is even formatted.
Full Changelog: https://github.com/electrikmilk/cherri/compare/v0.2.0-beta...v0.2.1-beta
In the last release, arguments for custom actions were implemented.
In a previous release, the implementation of embedding a standard library file stdlib.cherri in the compiler and pasting it in when an include statement containing 'stdlib' is used.
The first 2 standard library custom actions have been added with this release.
runJS(text script)The first is an implementation of running JavaScript code and getting the output.
const _ios17bug = replaceText("#", "\u0023", _script)
const _uri = url("data:text/html;charset=utf-8,<body/><script>{_ios17bug}</script>")
@richURI = _uri.richtext
const _decoded = urlDecode(richURI)
output("{_decoded}")
chooseFromVCard(array items, text prompt)The second is an implementation of taking an array of vCards and formatting them to be displayed in a chooseFromList() action and returns the chosen item.
const _menuItems = "{_items}"
const _vcf = setName(_menuItems, "cherri_chooseFromVCard.vcf")
@contact = _vcf.contact
const _chosenItem = chooseFromList(contact, _prompt)
output("{_chosenItem}")
There was recently an issue with Shortcut signing in macOS (https://github.com/electrikmilk/cherri/issues/49). Many users using Cherri have likely upgraded to the latest version of macOS and may have had problems downgrading or it wasn't worth it for their situation.
HubSign is a Shortcut signing service provided graciously by the folks over at RoutineHub that the compiler will now fall back on if signing using the shortcuts binary on macOS fails.
They maintain the service and will keep an eye out for issues with versions of macOS as they relate to Shortcut signing.
You can override any conditional use of HubSign by adding the flag --hubsign. Windows and Linux users can technically use this to create valid signed Shortcuts on their platform, it will just be a bit slower and they'll then need to move that file to an Apple device, but that's better than only being able to use the playground and not your favorite text editor.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Adds arguments to custom actions in https://github.com/electrikmilk/cherri/pull/48.
#include not being ignored.#include to use raw strings to improve compilation speed.#include generally.Full Changelog: https://github.com/electrikmilk/cherri/compare/v0.1.12-beta...v0.2.0-beta
main.The project is being featured on their homepage! On a carousel on their homepage, RoutineHub users will now be able to find out about Cherri. That's super cool!
I was also interviewed by them, which you can watch here! https://youtu.be/x0hwrQ51Sbs
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Adds built-in base64File() action.
PHOTO from generated vCards if not using an image.for and repeat statements.newContact action to handle variables for phoneNumber and emailAddress by @mikeogezi in https://github.com/electrikmilk/cherri/pull/43.0. However, we can only do this when it's an integer literal. So, this accepts the fact that Shortcuts starts counting at 1.WFWorkflowHasShortcutInputVariables.getFirstItem(), getLastItem(), getRandomItem().stopwithFull Changelog: https://github.com/electrikmilk/cherri/compare/v0.1.11-beta...v0.1.12-beta
I'm excited to talk about the fact that RoutineHub (a Shortcuts distribution platform), has taken an interest in the project and their support is greatly appreciated.
When I first got into Shortcuts like many people I found RoutineHub and their community very welcoming. It's a super cool and easy way to share your Shortcuts for others to use.
The RoutineHub team has been instrumental in creating the final piece of the playground: Signing.
This was a huge issue for a long time as only those with a Mac could use the compiler to produce Shortcuts they could import and run using the latest version of Shortcuts.
I had a path forward to accomplish this but not much experience in cloud deployment. Their team took this path forward and delivered a signing server the playground could use that signs Shortcuts.
Their discord, site, courses, etc. provide a lot of support to Shortcut development, and now they've helped this language to be accessible to A LOT more people.
They also wrote up an article about Cherri on their blog! This is huge for the project and I'm so excited to see where this relationship with them can go in the future.
I made a Cherri IDE for macOS. I was thinking about if a macOS app would work over an iOS app, turns out it was super easy to bundle the compiler with the app and call it from within the Swift code as a resource. This is not meant to replace the playground, as it will always have a purpose for those who only have Apple mobile devices and not a Mac.
It is for people who use macOS as their daily driver. It is a step further to make using Cherri even more accessible. I am hoping to someday release it on the Mac App Store, I think it would be a cool way for people to get into the language in a similar way to an iOS app on its App Store.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
bugfix: populate the (boolean) limit enabled argument when the (integer) limit is set by @mikeogezi in https://github.com/electrikmilk/cherri/pull/28
string -> text, integer -> number.WatchKit workflow type--action argumentsleep(), displaySleep(), shutdown(), reboot() and logout()removeBackground() and transcribeText() actionsshowNote() -> openNote()setCellularVoice() actionand more...
Full Changelog: https://github.com/electrikmilk/cherri/compare/v0.1.10-beta...v0.1.11-beta
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
fixes #20 by @erenyenigul in https://github.com/electrikmilk/cherri/pull/21 (Thanks! π€).
for and repeat statements.nil Read more.--action= argument for printing action definitions.runSelf() action.--comments flag is used.robot glyph.\n, \t and \r to string parsing.--output= argument is given.nil value type.Full Changelog: https://github.com/electrikmilk/cherri/compare/v0.1.9-beta...v0.1.10-beta
Nothing published for this version
Nothing published for this version
General refactoring and optimization.
output(), stop(), etc.) that it is unreachable or does not loop.-h or --help) flag. Prints usage information. Differs from running with no arguments in that it only prints usage information.-v or --version) flag. Prints version information.We now track the version in the compiler by a variable on a generated file that gets the latest tag which is pretty neat. go generate is not what I thought it was :P.
I got pretty distracted trying to add arguments to custom actions, so this release is kinda late and doesn't have as much as should match the amount of time since the last release, but still a lot of optimizations and improvements.
Full Changelog: https://github.com/electrikmilk/cherri/compare/v0.1.8-beta...v0.1.9-beta
Nothing published for this version
Nothing published for this version
Nothing published for this version
Tons of optimizations and fixes to compiler and actions
menu case -> item--auto-inc or -a) to automatically include all Cherri files in the same directory.Full Changelog: https://github.com/electrikmilk/cherri/compare/v0.1.7-beta...v0.1.8-beta
Nothing published for this version
Nothing published for this version
Finishes basically all of the built-in scripting actions (by adding Measurements & DND).
Full Changelog: https://github.com/electrikmilk/cherri/compare/v0.1.6-beta...v0.1.7-beta
One column per quarter.