← all repositories
viticci/shortcuts-playground-plugin

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.

991 stars Python Coding AssistantsAgents
shortcuts-playground-plugin
Not currently ranked — collecting fresh signals.
star history

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 shortcuts CLI.
  • 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.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.