{"id":13616763,"url":"https://github.com/electrikmilk/cherri","last_synced_at":"2025-05-02T23:48:01.889Z","repository":{"id":62006097,"uuid":"554016681","full_name":"electrikmilk/cherri","owner":"electrikmilk","description":"Siri Shortcuts Programming Language 🍒","archived":false,"fork":false,"pushed_at":"2025-04-22T21:23:15.000Z","size":1962,"stargazers_count":265,"open_issues_count":4,"forks_count":17,"subscribers_count":8,"default_branch":"main","last_synced_at":"2025-05-02T23:47:56.263Z","etag":null,"topics":["apple","apple-shortcuts","compiler","go","golang","ios","ios-shortcuts","macos","programming-language","siri-shortcuts"],"latest_commit_sha":null,"homepage":"https://cherrilang.org","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/electrikmilk.png","metadata":{"files":{"readme":"ReadMe.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":["electrikmilk"],"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"lfx_crowdfunding":null,"custom":["https://www.paypal.me/johnwaynepizzaparty","https://routinehub.co/user/electrikmilk"]}},"created_at":"2022-10-19T05:44:28.000Z","updated_at":"2025-05-02T06:56:08.000Z","dependencies_parsed_at":"2023-10-14T22:28:43.818Z","dependency_job_id":"dae89ca5-48eb-45f1-8f76-856a81320b7e","html_url":"https://github.com/electrikmilk/cherri","commit_stats":{"total_commits":335,"total_committers":2,"mean_commits":167.5,"dds":"0.0029850746268657025","last_synced_commit":"b26901fb8261c6358d5e482076ded3ec7651ab84"},"previous_names":[],"tags_count":49,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/electrikmilk%2Fcherri","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/electrikmilk%2Fcherri/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/electrikmilk%2Fcherri/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/electrikmilk%2Fcherri/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/electrikmilk","download_url":"https://codeload.github.com/electrikmilk/cherri/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252122858,"owners_count":21698321,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["apple","apple-shortcuts","compiler","go","golang","ios","ios-shortcuts","macos","programming-language","siri-shortcuts"],"created_at":"2024-08-01T20:01:32.967Z","updated_at":"2025-05-02T23:48:01.860Z","avatar_url":"https://github.com/electrikmilk.png","language":"Go","readme":"\u003cimg src=\"https://github.com/electrikmilk/cherri/blob/main/assets/cherri_icon.png\" width=\"200\"/\u003e\n\n# Cherri\n\n[![Build \u0026 Test](https://github.com/electrikmilk/cherri/actions/workflows/go.yml/badge.svg)](https://github.com/electrikmilk/cherri/actions/workflows/go.yml)\n[![Releases](https://img.shields.io/github/v/release/electrikmilk/cherri?include_prereleases)](https://github.com/electrikmilk/cherri/releases)\n[![Go](https://img.shields.io/github/go-mod/go-version/electrikmilk/cherri)](https://github.com/electrikmilk/cherri/blob/main/go.mod)\n[![License](https://img.shields.io/github/license/electrikmilk/cherri)](https://github.com/electrikmilk/cherri/blob/main/LICENSE)\n![Platform](https://img.shields.io/badge/platform-macOS-red)\n[![GoDoc](https://godoc.org/github.com/golang/gddo?status.svg)](https://pkg.go.dev/github.com/electrikmilk/cherri?tab=doc)\n[![Go Report Card](https://goreportcard.com/badge/github.com/electrikmilk/cherri)](https://goreportcard.com/report/github.com/electrikmilk/cherri)\n\n**Cherri** (pronounced cherry) is a [Shortcuts](https://apps.apple.com/us/app/shortcuts/id1462947752) programming language, that compiles directly to a valid runnable Shortcut.\n\nThe main goal is to make it trivial and practical to create large Shortcut projects (within the limits of Shortcuts) and maintain them long-term.\n\n[![Hello World Example](https://github.com/electrikmilk/cherri/assets/4368524/8532e8f7-245b-47f3-9691-8b1eac5774c7)](https://playground.cherrilang.org)\n\n### 🌟 Top Features\n\n- 🖥️ Laptop/Desktop based development (CLI, [VSCode extension](https://marketplace.visualstudio.com/items?itemName=electrikmilk.cherri-vscode-extension), macOS app)\n- 🎓 Easy to learn and syntax similar to other languages\n- 🐞 1-1 translation to Shortcut actions as much as possible to make debugging easier\n- 🪄 No magic variables syntax, they're constants instead\n- 🪶 Optimized to create as small as possible Shortcuts and reduces memory usage at runtime\n- #️⃣ Include files within others for large Shortcut projects\n- 🔧 Define custom actions\n- 📋 Copy-paste actions automatically\n- 🥩 Enter actions raw with custom identifier and parameters\n- ❓ Define import questions\n- 📇 Generate VCards for menus\n- 📄 Embed files in base64\n- 🔀 Convert Shortcuts from an iCloud link with the `--import=` option\n- 🔢 Type system and type inference\n\n### Resources\n\n- 🍒 [Cherri VSCode Extension](https://marketplace.visualstudio.com/items?itemName=electrikmilk.cherri-vscode-extension)\n- 🛝 [Playground](https://playground.cherrilang.org/) - Try out Cherri on any platform, preview the result, and export signed Shortcuts\n- 🖥️ [macOS IDE](https://github.com/electrikmilk/cherri-macos-app) - Defines Cherri file type, write and build Shortcuts on Mac with a GUI\n- 📄 [Documentation](https://cherrilang.org/language/) - Learn Cherri or how to contribute\n- 🔍 [Glyph Search](https://glyphs.cherrilang.org/) - Search glyphs you can use in Cherri!\n- ❓ [FAQ](https://cherrilang.org/faq)\n\n## 📣 WIP 📣\n\nThis project has not yet reached a stable version. It is under heavy development and backward\nincompatible changes may be made.\n\n## Usage\n\n```bash\ncherri file.cherri\n```\n\nRun `cherri` without any arguments to see all options and usage. For development, use the `--debug` (or `-d`) option to print\nstack traces, debug information, and output a `.plist` file.\n\n## Why macOS only?\n\nGenerating valid Shortcuts is only possible on macOS. However, there is a [Cherri Playground](https://playground.cherrilang.org) that outputs valid Shortcuts on any platform with a web\nbrowser.\n\n### Development on other platforms\n\nAs it stands, I don't want someone to get confused and think Shortcuts compiled using Cherri on other platforms will run\non their Mac or iOS device. However, you can build the compiler for your platform, it will just skip signing the\ncompiled Shortcut, so it will not run on iOS 15+ or macOS 12+. Also, note that the compiler is primarily developed and\ntested on Unix-like systems.\n\n[Read my full thoughts on this](https://cherrilang.org/faq#why-macos-only)\n\n## Why another Shortcuts language?\n\nBecause it's fun :)\n\nSome languages have been abandoned, don't work very well, or no longer work. I don't want Shortcuts languages to die.\nThere should be more, not less.\n\nPlus, 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](https://github.com/zachary7829/Buttermilk).\n\n## Community\n\n- [VS Code Syntax Highlighting](https://marketplace.visualstudio.com/items?itemName=erenyenigul.cherri) ([repo](https://github.com/erenyenigul/cherri-vscode-highlight))\n\n## Credits\n\n### Reference\n\n- [zachary7829/Shortcuts File Format Documentation](https://zachary7829.github.io/blog/shortcuts/fileformat)\n- [sebj/iOS-Shortcuts-Reference](https://github.com/sebj/iOS-Shortcuts-Reference)\n- [[Tip] Reducing memory usage of repeat loops](https://www.reddit.com/r/shortcuts/comments/taceg7/tip_reducing_memory_usage_of_repeat_loops/)\n\n### Inspiration\n\n- Go syntax\n- Ruby syntax\n- [ScPL](https://github.com/pfgithub/scpl)\n- [Buttermilk](https://github.com/zachary7829/Buttermilk)\n- [Jelly](https://jellycuts.com)\n\n---\n\n_The original Workflow app assigned a code name to each release. Cherri is named after the second to last\nupdate \"Cherries\" (also cherry is one of my favorite flavors)._\n\nThis project started on Oct 5, 2022.\n","funding_links":["https://github.com/sponsors/electrikmilk","https://www.paypal.me/johnwaynepizzaparty","https://routinehub.co/user/electrikmilk"],"categories":["HarmonyOS","Go"],"sub_categories":["Windows Manager"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Felectrikmilk%2Fcherri","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Felectrikmilk%2Fcherri","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Felectrikmilk%2Fcherri/lists"}