# viticci/shortcuts-playground-plugin

Shortcuts Playground: A Claude Code and Codex plugin for building, validating, signing, and remixing macOS/iOS Shortcuts with natural language.

Repository: https://github.com/viticci/shortcuts-playground-plugin
Canonical: https://ross.abutalabs.com/products/shortcuts-playground-plugin
Homepage: https://www.macstories.net/shortcuts/
Language: Python
License: MIT
License Family: permissive
Topics: apple, automation, claude, codex, ios, ipados, macos, shortcuts
Last push: 2026-06-15T14:26:38+00:00

## Health v2 (maintenance only)
Score: 72/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 87, release rhythm 89, longevity 10
- inputs: {"age_days": 141, "days_push": 79, "days_rel": 79, "gap_med": 3.5, "n_releases_24m": 5}
- flags: young
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1058, forks 51 (observed 2026-08-28T04:03:24.852535+00:00)

## What it is
Shortcuts Playground is a plugin for Claude Code and Codex that generates Apple Shortcuts from natural language descriptions. It ships a knowledge base of Shortcuts action syntax, validates generated XML in a loop, and signs shortcuts using Apple's native shortcuts CLI.

## Use cases
- create apple shortcuts from plain english descriptions
- build and sign .shortcut files automatically
- validate shortcut xml before importing into shortcuts app
- remix existing shortcuts with natural language
- generate shortcuts using os 27 actions like vpn or stage manager triggers
- automate ios and macos workflows without learning shortcuts editor

## When to choose
- you use Claude Code or Codex and want to author Apple Shortcuts quickly
- you want validated, signed .shortcut files without manually building them in the Shortcuts editor
- you need access to modern macOS/iOS 27 action catalogs and trigger metadata

## When to avoid
- you don't use Claude Code or Codex as your coding agent
- you need shortcuts for platforms other than macOS/iOS/iPadOS
- you require guaranteed compatibility with future Shortcuts app versions

## Facets
- artifact type: plugin
- maturity: active
- function: agent-framework, prompt-engineering, developer-tools, workflow-automation, form-handling
- domain: apple-ecosystem, developer-tools
- platform: python, cli
- tags: apple-shortcuts, claude-code, codex, shortcut-signing, xml-generation, macstories, natural-language-automation, automation, ai-agents, macos, ios

## Member repositories
- viticci/shortcuts-playground-plugin (main) score 72

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:24.852535+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T06:57:53.058704+00:00, confidence not recorded.
  - readme: https://github.com/viticci/shortcuts-playground-plugin (fetched 2026-08-28T04:03:24.852535+00:00, sha 7d3fba0176df)
  - homepage: https://www.macstories.net/shortcuts/ (fetched 2026-08-29T12:59:44.768513+00:00, sha e044bd336b3d)
- Data as of 2026-08-30T08:39:29.467469+00:00.