Your AI agent now speaks fluent Apple Shortcuts XML
It exists because wiring Shortcuts by hand is tedious, so it lets you describe automation in plain English and receive a validated, signed `.shortcut` file back.

What it does
Shortcuts Playground is a plugin for Claude Code and Codex that generates macOS and iOS Shortcuts from plain-English descriptions. You tell the agent what you want—fetch weather, resize images, SSH into a server—and it designs the action list, wires variables, picks an icon, and hands you a signed .shortcut file ready for the Shortcuts app. The whole pipeline runs on macOS, leaning on Apple’s native shortcuts CLI to handle the proprietary signing step.
The interesting bit
The plugin ships a ~12,000-line knowledge base that teaches the agent how Shortcuts actions connect, plus 56 best-practice rules and 19 golden-example XML files derived from Apple’s ToolKit. A PostToolUse hook called the Craig Loop validates every XML write and feeds errors back into the agent’s context, letting it self-correct before signing. It is essentially a domain-specific compiler target for a proprietary Apple format, bolted onto an LLM.
Key highlights
- Generates new shortcuts from plain English or surgically remixes existing unsigned XML, preserving untouched actions and UUIDs.
- Validates XML through a self-correcting “Craig Loop” using a bundled Python validator, then signs the result with Apple’s native
shortcutsCLI. - Ships a ~12,000-line knowledge base with 56 best-practice rules, verified action identifiers from Apple’s ToolKit v63, and 19 golden example XMLs.
- Dual-runtime support: a full Claude Code plugin with slash commands and hooks, plus a slimmer Codex-compatible version.
- Bound to macOS; the signing step requires Apple’s native CLI, and the bundled validator needs Python 3.10+.
Caveats
- The author estimates it gets you about 90% of the way there; variable connections inside repeat loops and empty fields may still need manual cleanup in the Shortcuts app.
- The richer experience is currently Claude Code–only; Codex users get a slimmer feature set and must explicitly enable plugin hooks for automatic validation.
- A companion shortcut for remote iPhone and iPad generation over SSH is locked behind a paid Club MacStories membership.
Verdict
Mac-based automation nerds who already live in Claude Code or Codex will save real time here. If you are not on macOS or you do not use those agent tools, this plugin has nothing to offer you.
Frequently asked
- What is viticci/shortcuts-playground-plugin?
- It exists because wiring Shortcuts by hand is tedious, so it lets you describe automation in plain English and receive a validated, signed `.shortcut` file back.
- Is shortcuts-playground-plugin open source?
- Yes — viticci/shortcuts-playground-plugin is open source, released under the MIT license.
- What language is shortcuts-playground-plugin written in?
- viticci/shortcuts-playground-plugin is primarily written in Python.
- How popular is shortcuts-playground-plugin?
- viticci/shortcuts-playground-plugin has 991 stars on GitHub.
- Where can I find shortcuts-playground-plugin?
- viticci/shortcuts-playground-plugin is on GitHub at https://github.com/viticci/shortcuts-playground-plugin.