Documentation
Welcome to the Jelly Programming Language documentation. This website will guide you through your first Jelly script and provide general information on the language. It will also provide information on using the main Jelly IDE Jellycuts.
The Jelly Programming Language
The Jelly programming language was created to code Siri Shortcuts in a text base language. This is why the language is currently structured around calling functions.
The Shortcuts Library
The standard Jelly library is the Shortcuts Library. This library contains functions that are easily translated directly into default Shortcuts actions. Documentation for this library can be found on the Shortcuts Standard Page.
March 2026 Language + IDE Milestone (March 14, 2026)
The March 14, 2026 milestone focused on language ergonomics, diagnostics quality, and editor stability for large files.
Language Highlights
- Expression assignment resolution now supports list literals, function calls, binary math, and index lookups.
- Return statements now resolve expression right-hand sides in addition to plain variable names.
- Typed function parameter declarations (for example
func test(value: str)) bind the parameter identifier correctly.
- Generated magic variable names now use a compact
GMV- prefix.
- Diagnostics now include
columnNumber for richer source pinpointing.
- False deprecation warnings for spaces in variable names were reduced by stricter identifier checks.
IDE Highlights
- Wrap Text While Coding behavior was stabilized and wrap preference is preserved when reopening projects.
- Wrap-off mode now reliably keeps horizontal scrolling behavior for long lines.
- Caret visibility in wrapped text was improved so typing position stays reachable.
- Highlighting cadence was tuned for better responsiveness in long, base64-heavy files.
- Console diagnostics now include clearer line markers, variable emphasis, and tap-to-jump navigation to source.
