Mac-Shortcuts-Automatisierung: Das Praxisreferenzwerk (2026)

TL;DR: Shortcuts ist seit macOS Monterey (2021) auf jedem Mac verfügbar, und macOS Tahoe (26) brachte endlich das, worauf Mac-Automatisierer vier Jahre lang gewartet hatten: persönliche Automationen mit Auslösern wie Ordneränderungen, externen Laufwerken, Wi-Fi, Displays und App-Starts.³⁴ Die App führt Shortcuts über die Menüleiste, Spotlight, Finder Quick Actions, Tastaturkurzbefehle und ein echtes Kommandozeilenwerkzeug (shortcuts run, list, view, sign) aus.¹² Jede App kann über das App Intents-Framework Aktionen hinzufügen – dieselbe Schnittstelle, die auch Siri, Spotlight und Apple Intelligence verwenden.¹³ Skripte und KI-Agenten steuern Shortcuts auf drei Arten: über die CLI, das URL scheme shortcuts:// und den skriptfähigen Hintergrundprozess Shortcuts Events.¹⁹¹¹ Mit dem Berechtigungsmodell sollten Sie sich zuerst vertraut machen: Zustimmungsdialoge, die in der App nicht auffallen, können eine unbeaufsichtigte Ausführung unbemerkt anhalten.

Auf der WWDC 2021 erklärte Apple Entwicklern: „Shortcuts ist die Zukunft der Mac-Automatisierung.“⁵ Diese Zukunft kam in zwei Etappen. Die erste wurde sofort ausgeliefert: eine native SwiftUI-App für macOS Monterey mit iCloud-Synchronisierung, einem Automator-Migrationswerkzeug und vollständiger Unterstützung für Shell-Skripte und AppleScript innerhalb des Editors.⁵ Die zweite ließ vier weitere macOS-Versionen auf sich warten. Bis macOS Tahoe wurde ein Shortcut auf dem Mac nur ausgeführt, wenn er von etwas aufgerufen wurde; Auslöser gab es nicht, sodass „Automatisierung“ bedeutete, daran zu denken, selbst zu klicken. Tahoe schloss diese Lücke mit persönlichen, eigens für den Mac entwickelten Automationen (Auslöser für Ordner und externe Laufwerke), ergänzte sie um die von iOS bekannten Auslöser (Tageszeit, Bluetooth) und fügte die Aktion Use Model hinzu, die Apple Intelligence in den Datenfluss eines Shortcuts einbindet.³⁴

Das Ergebnis ist ein System, mit dem sich eine gründliche Beschäftigung lohnt. Shortcuts auf dem Mac vereint 2026 vier Funktionen:

1. Ein No-Code-Editor mit Hunderten integrierten Aktionen, von Dateioperationen über die Fensterverwaltung bis hin zu On-Device-KI
2. Eine Automatisierungs-Engine mit Auslösern für Systemereignisse, neu in macOS Tahoe
3. Ein vollwertiges Kommandozeilenwerkzeug: shortcuts run verhält sich wie jedes andere Unix-Werkzeug – mit stdin, stdout, Exit-Codes und Pipes¹
4. Ein Aktionsregister für jede App: Alles, was eine App über App Intents bereitstellt, erscheint automatisch in Shortcuts – auf dem Mac ebenso wie auf allen anderen Plattformen¹³⁴

Der Unterschied zwischen gelegentlicher und professioneller Nutzung hängt von fünf Systemen ab: dem Aktionskatalog (was verfügbar ist), den Automatisierungsauslösern (wann etwas ausgeführt wird), der CLI und den Skript-Schnittstellen (wie Code Shortcuts aufruft), der Signierung und Freigabe (wie Shortcuts weitergegeben werden) sowie dem Berechtigungsmodell (warum unbeaufsichtigte Ausführungen ins Stocken geraten). Jeder dieser Bereiche erhält im Folgenden einen eigenen Abschnitt.

Jede Aussage in diesem Leitfaden stützt sich auf die Dokumentation von Apple, WWDC-Sessions oder die direkte Untersuchung von macOS 26.5 (Shortcuts 7.0) auf dem Mac, auf dem der Leitfaden verfasst wurde. Wenn eine Information direkt aus dem Betriebssystem stammt – etwa aus der Manpage shortcuts(1), dem Skriptwörterbuch von Shortcuts Events oder den Aktionen im WorkflowKit-Framework –, ist dies in der Quellenangabe entsprechend vermerkt.

Wichtigste Erkenntnisse

• Automationen stehen im Mittelpunkt. macOS Tahoe brachte persönliche Automationen auf den Mac: Ordneränderungen, externe Laufwerke, Displays, Wi-Fi, Bluetooth, Stage Manager, App-Start/-Beenden, Tageszeit und mehr – jeweils sofort oder nach Bestätigung ausführbar.³⁴
• Die CLI ist echt, kein Spielzeug. shortcuts run "Name" -i input -o output unterstützt stdin (-i -), stdout (-o -), typisierte Ausgabe über Uniform Type Identifiers und beendet sich bei Erfolg mit 0, bei Fehlern mit 1. Sie können sie wie jedes Unix-Tool per Pipe verwenden.¹²
• Drei Skripteinstiegspunkte, eine Regel. Verwenden Sie die CLI aus Shells und CI, das URL scheme shortcuts:// nur aus anderen Apps und Shortcuts Events (AppleScript/ScriptingBridge), wenn Sie Ergebnisse in einem Skriptkontext zurückbenötigen, ohne die App zu öffnen.¹⁹¹¹
• Die Signierung steuert die Verteilung. Eine .shortcut-Datei muss signiert sein, um weitergegeben werden zu können: shortcuts sign -m anyone beglaubigt sie über iCloud, sodass sie jeder importieren kann; der Standardmodus people-who-know-me signiert lokal und beschränkt den Import auf Personen, die Sie in ihren Kontakten haben.²⁷
• App Intents ist die Oberfläche für Entwickler. Eine App mit App Intents erhält Shortcuts-Aktionen auf dem Mac ohne zusätzlichen Aufwand; dieselben Intents versorgen auch Spotlight und Automationen, einschließlich iOS-Apps, die auf Apple silicon Macs installiert sind.⁴¹³
• Einwilligung ist der häufigste Fehlerfall. Shortcuts fragt für jeden Kurzbefehl und jeden Datentyp nach Einmal erlauben / Immer erlauben / Nicht erlauben. Skriptausführende Aktionen stehen hinter einem globalen Schalter „Ausführen von Skripten erlauben“. Eine unbeaufsichtigte Ausführung, die auf eine unbeantwortete Abfrage trifft, wartet einfach.¹⁶⁸

So verwenden Sie diesen Leitfaden

Inhaltsverzeichnis

Teil 1: Grundlagen

1. Was ist Shortcuts auf dem Mac?
2. Möglichkeiten zum Ausführen eines Kurzbefehls
3. Shortcuts vs. Automator vs. AppleScript

Teil 2: Aktionen

1. So werden Aktionen zusammengesetzt
2. Der Aktionskatalog
3. Skripting-Aktionen
4. Aktionen zur Fensterverwaltung
5. Die Aktion Use Model

Teil 3: Automationen

1. Automationsauslöser unter macOS
2. Automationsmuster, die funktionieren

Teil 4: Die Befehlszeile und URL-Schemata

1. Die shortcuts CLI
2. Die App mit Shortcuts Events skripten
3. URL-Schemata

Teil 5: Freigabe und Verteilung

1. Freigabeformate und Signierung

Teil 6: Die Oberfläche für Entwickler

1. App Intents: So fügen Apps Aktionen hinzu
2. Spotlight und Automationen führen Ihre Intents aus
3. Shortcuts aus Skripten und Agents steuern

Teil 7: Betrieb und Referenz

1. Berechtigungen und Einwilligung (TCC)
2. Fehlerbehebung
3. Schnellreferenz
4. FAQ
5. Änderungsprotokoll
6. Referenzen

Was ist Shortcuts auf dem Mac?

Shortcuts ist Apples Automations-App: Sie verketten Aktionen (Einzelschritte mit einem Zweck) zu einem Kurzbefehl (einem gespeicherten Workflow) und führen ihn dann per Klick, Sprache, Tastenkombination, Auslöser oder Befehlszeile aus. Apples eigene Definition sollten Sie im Hinterkopf behalten, denn sie erklärt das gesamte Design: „Eine Aktion ist der Baustein eines Kurzbefehls. Jeder Kurzbefehl besteht aus einer Reihe von Aktionen, und jede Aktion ist ein einzelner Schritt, der eine bestimmte Funktion ausführt.“¹²

Die App kam 2021 mit macOS Monterey auf den Mac, von iOS portiert, aber fast vollständig in SwiftUI geschrieben, sodass dieselbe Codebasis beide Plattformen bedient.⁵ Drei Designentscheidungen aus dieser ersten Version prägen die Mac-Erfahrung auch 2026 noch:

• iCloud-Synchronisierung ist der Standard. Öffnen Sie Shortcuts auf einem neuen Mac, erscheint Ihre vorhandene Mediathek, synchronisiert von iPhone und iPad. Ein auf einem Gerät erstellter Kurzbefehl läuft auch auf den anderen, abzüglich plattformspezifischer Aktionen.⁵¹²
• Apps liefern Aktionen. „Wie unter iOS kann jede App auf dem Mac Aktionen für Shortcuts bereitstellen.“⁵ 2026 ist diese Pipeline das App Intents-Framework, das in Teil 6 behandelt wird.
• Skripte sind erstklassig. Monterey lieferte „vollständige Unterstützung für AppleScripts und Shell Scripting“ mit „neuen, direkt in Shortcuts integrierten Aktionen, mit denen Sie Skripte direkt im Shortcuts-Editor schreiben und ausführen können“. Damit umschließt Shortcuts den älteren Automations-Stack, statt ihn zu ersetzen.⁵

Was Monterey nicht lieferte, waren Auslöser. Von 2021 bis 2024 lief ein Mac-Kurzbefehl nur, wenn etwas ihn aufrief. macOS Tahoe (26) änderte das 2025, indem es persönliche Automationen auf den Mac brachte – mit speziell für Desktop-Workflows entwickelten Auslösertypen (Ordnerinhalt geändert, externes Laufwerk verbunden) sowie dem etablierten iOS-Set.³⁴ Tahoe fügte außerdem die Aktion Use Model hinzu, die Daten innerhalb eines Kurzbefehls durch Apple Intelligence-Modelle sendet.³⁴

Versionsmeilensteine:

Im gesamten Leitfaden bedeutet „unter macOS 26.5 verifiziert“, dass dies direkt mit Shortcuts 7.0 auf dem Mac geprüft wurde, auf dem dieser Leitfaden geschrieben wurde.

Möglichkeiten zum Ausführen eines Kurzbefehls

Shortcuts auf dem Mac bietet ungewöhnlich viele Einstiegspunkte. Alle folgenden Möglichkeiten rufen denselben Kurzbefehl auf; sie unterscheiden sich darin, woher die Eingabe kommt und wohin die Ausgabe gelangt.¹²¹⁰

Zwei Details sparen später Zeit. Erstens erhalten Quick Action- und Services-Einträge die aktuelle Auswahl als Kurzbefehlseingabe. Deshalb sollten Kurzbefehle zur Dateiverarbeitung ihre akzeptierten Eingabetypen (die Konfiguration „Receive“ im Editor) deklarieren, statt Text vorauszusetzen. Zweitens bilden die letzten drei Zeilen die programmierbare Oberfläche; sie erhalten eigene Abschnitte, weil sich ihre Ein-/Ausgabeverträge unterscheiden.

Shortcuts vs. Automator vs. AppleScript

Alle drei Automatisierungssysteme von Apple sind auch 2026 noch Bestandteil von macOS (Automator befindet sich weiterhin unter /System/Applications, verifiziert unter macOS 26.5), und jedes erfüllt nach wie vor seinen Zweck. Folgende Einordnung hat Bestand: Shortcuts bildet die Integrationsschicht, AppleScript ist die Sprache zur App-Steuerung und Shell-Skripte bilden die Berechnungsschicht. Automator befindet sich im Wartungsmodus: funktionsfähig, unverändert und offiziell durch Shortcuts abgelöst.⁵¹⁴

Der Migrationspfad ist real, an den Rändern jedoch verlustbehaftet. Apple hat einen Konverter in Shortcuts integriert: Ziehen Sie eine .workflow-Datei in die App (oder wählen Sie bei gedrückter Control-Taste „Open With“ → „Shortcuts“), und „Shortcuts kann die meisten Automator-Workflows in Shortcuts konvertieren, die dieselben Funktionen, Ereignisse und Automationen ausführen“.¹⁴¹⁵ „Die meisten“ ist Apples Formulierung. In der Praxis bedeutet das: Standard-Actions für Dateien, Bilder und Text lassen sich sauber konvertieren; bei weniger verbreiteten Automator-Actions von Drittanbietern und Watch Me Do-Aufzeichnungen lässt die Konvertierungsqualität nach. Als Teil dieser Kompatibilitätsstrategie führt Shortcuts intern sogar weiterhin eine Action namens Watch Me Do (sichtbar in der Action-Tabelle des Frameworks, verifiziert unter macOS 26.5).¹⁶

Wann Sie über Shortcuts hinausgehen sollten. Die tiefgreifende Steuerung einzelner Apps – etwa das Durchlaufen von Mail-Nachrichten, die programmgesteuerte Bearbeitung von Finder-Fenstern oder die Steuerung von Apps über umfangreiche Scripting Dictionaries – bleibt die Domäne von AppleScript. Komplexe Textverarbeitung, die Orchestrierung von API und alles, was Sie ohnehin in Python oder zsh schreiben würden, gehört in ein Skript. In der Praxis zählt die Kombination, nicht die Treue zu einem einzelnen System: Ein Shortcut, der Eingaben über einen Auslöser erfasst, sie für die aufwendige Verarbeitung an ein Shell-Skript übergibt und native Actions für Benachrichtigungen und die Dateiablage nutzt, vereint die Stärken aller Systeme. Der Abschnitt Scripting Actions behandelt die technische Umsetzung.

So werden Actions kombiniert

Jeder Shortcut ist eine Pipeline. Jede Action nimmt eine Eingabe entgegen (häufig die Ausgabe der vorherigen Action), erledigt eine Aufgabe und erzeugt eine Ausgabe. Drei Mechanismen verleihen dieser Pipeline ihre Ausdrucksstärke:

• Magic Variables. Die Ausgabe jeder Action steht späteren Actions automatisch als Variable zur Verfügung, ohne dass Sie etwas deklarieren müssen. Klicken Sie auf ein Parameterfeld, wählen Sie Select Magic Variable und anschließend die Ausgabe einer vorherigen Action aus. Set Variable und Get Variable dienen der expliziten Benennung, während Add to Variable Listen ergänzt (alle drei sind integrierte Actions, verifiziert unter macOS 26.5).¹⁶
• Inhaltstypen, bei Bedarf konvertiert. Actions geben an, welche Inhalte sie akzeptieren (Dateien, Bilder, Text, URLs, Datumsangaben). Unterscheiden sich Ausgabe- und Eingabetyp, führt Shortcuts nach Möglichkeit eine Konvertierung durch: Übergeben Sie eine Webseite an eine Text-Action, erhalten Sie den Seitentext. Die Konfiguration „Receive“ am Anfang eines Shortcuts legt fest, welche Eingaben der gesamte Shortcut über Quick Actions, Services oder --input-path des CLI akzeptiert.
• Ablaufsteuerung als Actions. If, Repeat, Repeat with Each, Choose from Menu, Wait to Return, Stop This Shortcut und Stop and Output sind gewöhnliche Actions.¹⁶ Stop and Output ist auf dem Mac wichtiger als auf jeder anderen Plattform: Die Action legt fest, was ein Shortcut an die Befehlszeile, eine Pipe oder ein aufrufendes Skript zurückgibt.¹

Das grundlegende Element für die Kombination ist Run Shortcut: Ein Shortcut ruft einen anderen anhand seines Namens und mit einer Eingabe auf.¹⁶ Apple weist ausdrücklich darauf hin, dass für Verschachtelungen die Action und nicht URL schemes verwendet werden sollen: „Wenn Sie einen Shortcut aus einem anderen Shortcut heraus ausführen möchten, verwenden Sie anstelle eines URL scheme die Action Run Shortcut.“⁹ Behandeln Sie Shortcuts wie Funktionen: Kleine Shortcuts mit jeweils einem klaren Zweck (einen Dateinamen normalisieren, Daten an einen Webhook senden, ein Bild auf Miniaturgröße skalieren), die von einem koordinierenden Shortcut kombiniert werden, lassen sich wesentlich besser skalieren als ein Monolith mit 60 Actions. Zudem bleibt jeder Bestandteil unabhängig über den CLI testbar.

Der Actions-Katalog

Die integrierte Bibliothek ist umfangreich: Die Tabelle mit englischen Zeichenfolgen im WorkflowKit-Framework von macOS 26.5 (dem privaten Framework hinter Shortcuts) enthält 361 unterschiedliche Action-Namen.¹⁶ Diese Zahl überzeichnet allerdings den Umfang, der Ihnen im Editor angezeigt wird: Die Tabelle umfasst sowohl iOS-exklusive Actions als auch ältere Integrationen aus der Workflow-Vergangenheit der App. Der folgende Mac-relevante Katalog ist danach gegliedert, was Benutzer für Automationen tatsächlich benötigen. Jeder der nachfolgenden Action-Namen erscheint wortgetreu in dieser Tabelle, verifiziert unter macOS 26.5.¹⁶

Dateien und Finder

System und Apps

Web und Daten

Get Contents of URL bildet zusammen mit den Dictionary-Actions einen brauchbaren REST-Client: Anfrage senden, JSON parsen und Werte extrahieren – ganz ohne Code. Bei komplexeren Nutzdaten sollten Sie die Verarbeitung an ein Shell-Skript mit curl und jq übergeben, anstatt im Editor mit verschachtelten Dictionaries zu kämpfen.

Text, Bilder und Medien

Kalender, Erinnerungen, Kontakte und Notizen

Find Calendar Events, Add New Calendar, Edit Calendar Event, Find Reminders, New Reminder, Edit Reminder, Find Contacts, Edit Contact, Create New Note, Get Notes, Delete Notes und die entsprechenden Get Details of…-Actions decken die Produktivitäts-Apps ab.¹⁶ Die Kombination aus Find/Filter und Get Details folgt dabei einem festen Muster: Zunächst wird eine Sammlung durchsucht, anschließend werden Felder aus den Treffern extrahiert.

Shortcuts, Meta-Actions und Ablaufsteuerung

Ein Hinweis zur Meta-Automation für Teil 6: Mit Get My Shortcuts und Get Details of Shortcut kann ein Shortcut die Bibliothek auflisten. Zusammen mit shortcuts list auf der CLI-Seite lassen sich so Werkzeuge rund um Ihre Sammlung entwickeln.¹⁶²

Skripting-Aktionen

Fünf Aktionen verbinden Shortcuts mit dem klassischen Automatisierungsstack, und alle fünf stehen hinter einem globalen Schalter. In Shortcuts → Einstellungen → Erweitert muss „Ausführen von Skripten erlauben“ aktiviert sein, bevor eine davon ausgeführt wird; die eigene Beschreibung der App nennt genau, welche Aktionen davon gesteuert werden: „When enabled, the actions ‘Run AppleScript’, ‘Run Shell Script’, ‘Run JavaScript for Mac Automation’, ‘Run JavaScript on Web Page’ and ‘Run Script Over SSH’ can be run“ (überprüft unter macOS 26.5).⁸¹⁷ Apples Dokumentation ergänzt den Warnhinweis, dass das Ausführen von Shortcuts mit Skripten zu Datenverlust führen könnte — diese Einstellung gibt es, weil diese fünf Aktionen mit Ihren vollständigen Benutzerberechtigungen und außerhalb der Schutzmechanismen ausgeführt werden, die gewöhnliche Aktionen begrenzen.⁸

Shell-Skript ausführen

Das Arbeitspferd. Sie wählen die Shell, fügen das Skript ein und legen fest, wie die Eingabe ankommt. Die beiden Eingabemodi stammen direkt aus der eigenen Dokumentation der Aktion: „to stdin: The input will be converted to a file and directed to the stdin pipe of the script. as arguments: The input will be converted to a list of strings and passed as arguments to the script.“¹⁷

Praktische Auswirkungen dieser beiden Modi:

• Der stdin-Modus eignet sich für Text und einzelne Dateien: Verarbeitung im Stil von pbpaste, JSON über jq, alles, was einen Datenstrom liest.
• Der arguments-Modus eignet sich für mehrere Dateien: Jedes Eingabeelement landet in "$@", sodass for f in "$@"; do ... done eine Auswahl im Finder korrekt verarbeitet — einschließlich Leerzeichen.
• Die Ausgabe ist alles, was das Skript nach stdout schreibt, und fließt wie jede andere Ausgabe in die nächste Aktion.

AppleScript ausführen und JavaScript für Mac-Automatisierung ausführen

Beide betten Open-Scripting-Architecture-Skripte mit einem Einstiegspunkt on run {input, parameters} (AppleScript) beziehungsweise einer Funktion run(input, parameters) (JXA) ein. Greifen Sie darauf zurück, wenn die Aufgabe eine andere App steuert: Fensteranordnung im Finder, Mail-Regeln oder alles mit einem Scripting Dictionary. Der Rückgabewert wird zur Ausgabe der Aktion.

Skript über SSH ausführen

Führt ein Shell-Skript auf einem Remote-Host aus, wobei Host, Port, Benutzer und Authentifizierung in der Aktion konfiguriert werden. Der entscheidende Anwendungsfall ist symmetrisch zur CLI: Ein Mac in Ihrem Büro kann wiederholbare Vorgänge für jede Maschine bereitstellen, die ihn über SSH erreichen kann, und ein Shortcut kann Arbeit auf Linux-Rechner auslagern, ohne dass Sie den Shortcuts-Editor verlassen müssen.

JavaScript auf Webseite ausführen

Führt JavaScript auf der aktuellen Safari-Seite aus und gibt das Ergebnis zurück. Apple schützt dies sowohl über den Skriptschalter als auch über eine Berechtigungsabfrage bei jeder Ausführung, weil beliebiges JavaScript im Seitenkontext eine Oberfläche für Datenexfiltration darstellt.⁸

Aktionen zur Fensterverwaltung

Shortcuts bietet auf dem Mac native Fenstersteuerung: Fenster suchen, Fenster bewegen und Fenstergröße ändern.¹⁶ Sie wirken wie unbedeutende Katalogeinträge, erweisen sich jedoch als Bausteine für tastaturgesteuerte Fensterlayouts ohne Drittanbieter-Tools.

• Fenster suchen fragt offene Fenster ab (im Editor sortier- und filterbar) und gibt Fensterobjekte aus.
• Fenster bewegen übernimmt ein Fenster und eine Position. Die Parameterzusammenfassung lautet „Move ⟨Window⟩ to ⟨Position⟩“, mit einer optionalen benutzerdefinierten Variante „Move ⟨Window⟩ to ⟨Position⟩ ⟨X Coordinate⟩, ⟨Y Coordinate⟩“ (überprüft unter macOS 26.5).¹⁶
• Fenstergröße ändern übernimmt ein Fenster und ein Ziel: „Resize ⟨Window⟩ to ⟨Configuration⟩“, mit einer benutzerdefinierten Variante, die explizite Werte für ⟨Width⟩ × ⟨Height⟩ akzeptiert.¹⁶

Die integrierten Fensterpositionen in der Stringtabelle des Frameworks: Vollbild, Links, Rechts, Oben, Unten, Drittel (Linkes Drittel, Mittleres Drittel, Rechtes Drittel), Eckvarianten (Oben/Unten Führend und Nachlaufend) sowie ein benutzerdefiniertes Format für Fensterposition und -größe (überprüft unter macOS 26.5).¹⁶ Kombinieren Sie Fenster suchen (vorderstes Fenster) → Fenstergröße ändern (Links) mit einem Tastaturkurzbefehl, und Sie erhalten einen Fensterbefehl mit einer Taste. Split Screen Apps deckt den Fall mit zwei Apps in einer einzigen Aktion ab.¹⁶

Die Aktion Use Model

Neu in macOS Tahoe und die folgenreichste einzelne Aktion, die Apple seit der Mac-Portierung hinzugefügt hat: Use Model sendet Daten während eines Shortcuts an ein Apple-Intelligence-Modell und übergibt die Antwort an die nächste Aktion.³⁴

Drei Modellauswahlen laut Apples WWDC-Session zu dieser Funktion: ein großes serverbasiertes Modell auf Private Cloud Compute, das On-Device-Modell „for simple requests without network connection“ und ChatGPT „for broad world knowledge“.⁴

Drei Ausgabeformen — und die bewusste Auswahl ist die entscheidende Fähigkeit:⁴

1. Text (einschließlich Rich Text) für Zusammenfassungen und Überarbeitungen.
2. Wörterbuch für strukturierte Extraktion; Apples Beispiel ist das Herausziehen von Lieferant, Betrag und Datum aus Rechnungen. Die Wörterbuchausgabe macht Use Model zusammensetzbar: Nachgelagerte Aktionen lesen Felder, statt Fließtext zu analysieren.
3. App-Entitäten: Inhaltsobjekte aus Apps, die sie über App Intents bereitstellen. Apple beschreibt die Beziehung so: „If App Intents are the actions or verbs from your app, App Entities are the nouns“,⁴ und Use Model kann direkt über diese Substantive nachdenken (diese Notizen filtern, das passende Kalenderereignis auswählen).

Mit einem Umschalter Follow Up können Sie innerhalb derselben Ausführung auf der Antwort des Modells aufbauen.⁴

Ein technischer Hinweis: Modellausgaben sind nicht deterministisch, daher kann dieselbe Eingabe bei verschiedenen Ausführungen unterschiedliche Ergebnisse erzeugen. Für Automatisierungen spricht das für die Wörterbuchausgabe (durch ein Schema eingeschränkt), kleine fokussierte Prompts und einen Validierungsschritt (eine If-Aktion, die erforderliche Felder prüft), bevor das Ergebnis Dateien oder Nachrichten berührt. Behandeln Sie Use Model wie einen unzuverlässigen Netzwerkaufruf: nützlich, aber mit Prüfungen umschlossen.

Die Entwicklerperspektive auf dieselbe Funktion (was Ihre App bereitstellen sollte, damit Use Model darüber nachdenken kann) finden Sie in Teil 6 und im App-Intents-Cluster auf dieser Website, beginnend mit App Intents Are Apple’s New API to Your App.

Automatisierungsauslöser unter macOS

Automatisierungen sind Shortcuts mit einem angehängten Auslöser: „Führe dies aus, wenn das geschieht“ — kein Klick erforderlich. Sie kamen mit macOS Tahoe auf den Mac, und Apple entwickelte Mac-spezifische Auslöser, statt die iOS-Liste einfach vollständig zu übernehmen: „we’re bringing personal automations to the Mac, with new automation types like folder and external drive automations built specifically for Mac, along with automation types you might already be familiar with from iOS, like Time of Day and Bluetooth.“⁴

Erstellen Sie sie im Bereich Automatisierung der Shortcuts-App. Jede Automatisierung kombiniert einen Auslöser mit einer Reihe von Aktionen und einer Grundsatzentscheidung: Sofort ausführen (keine Interaktion, der Kern der Automatisierung) oder Nach Bestätigung ausführen (zuvor fragt eine Mitteilung nach).³¹⁸ Starten Sie neue Automatisierungen mit Bestätigung, bis Sie ihnen vertrauen, und wechseln Sie anschließend zu sofortiger Ausführung.

Der Auslöserkatalog unter macOS Tahoe:³⁴¹⁸

Aus dem Design ergeben sich zwei Veränderungen. Erstens verfügt der Mac endlich über eine Apple-native Antwort auf „Diesen Ordner überwachen und alles verarbeiten, was darin landet“, die sich wie jeder andere Shortcut synchronisieren und bearbeiten lässt (Automators Folder Actions übernahmen die Überwachung, aber nicht den Rest). Zweitens gilt: Weil Automatisierungen Shortcuts ausführen, verstärkt sich alles in diesem Leitfaden gegenseitig — ein Ordner-Auslöser kann Shell-Skript ausführen speisen, ein App-Auslöser kann Use Model aufrufen und ein Auslöser für externe Laufwerke kann einen SSH-Job starten.

Bewährte Automatisierungsmuster

Muster, die sich im täglichen Einsatz bewähren und vollständig aus dokumentierten Bausteinen bestehen:

Der überwachte Ordner. Ordnerauslöser für ~/Inbox → Dateien filtern (Erweiterung ist pdf) → Text aus Bild extrahieren oder Text aus PDF abrufen → Use Model mit Wörterbuchausgabe (Anbieter, Datum, Gesamtbetrag) → Datei umbenennen und Datei in eine Archivhierarchie verschieben. Der klassische Automator-Anwendungsfall, erweitert um Extraktion auf dem Gerät und modellgestützte Benennung.³⁴¹⁶

Die Schreibtisch-Dockingstation. Displayauslöser (externes Display wird verbunden) → Apps für Ihre Arbeitsumgebung öffnen → Fenster entsprechend Ihrem Layout verschieben und skalieren → Fokus auf Arbeit setzen. Beim Trennen führen Sie die Schritte umgekehrt aus. Ein einziger Auslöser stellt das gesamte Schreibtischlayout wieder her, ohne dass Sie Fenster manuell verschieben müssen.³¹⁶

Das Importlaufwerk. Auslöser für externes Laufwerk → Inhalt des DCIM-Ordners auf der Karte abrufen → Dateien nach Datum filtern → Datei in einem datierten Ordner speichern → Mitteilung mit der Anzahl anzeigen. Hier empfiehlt sich der Bestätigungsmodus: Laufwerke, mit denen Sie nicht gerechnet haben, sollten keine Massenkopien auslösen.³¹⁸

Der Ausweg zu echtem Code. Beliebiger Auslöser → Shell-Skript ausführen, wobei die Eingabe als Argumente übergeben wird → Ihr vorhandenes Skript. Der wertvolle Teil ist das Auslösersystem; die Logik muss keineswegs in Shortcuts-Actions umgesetzt werden. Eine Automatisierung mit zwei Actions (Auslöser + Skript) bietet eine launchd-ähnliche Ereignisverarbeitung samt Benutzeroberfläche, Synchronisierung und Einwilligungsverwaltung.⁸¹⁷

Kontexte rund um Besprechungen. Fokusauslöser (Arbeitsfokus ein)¹⁸ → Lautstärke einstellen, ablenkende Apps beenden, Notizen-App öffnen. Ist die geräteübergreifende Fokussynchronisierung in den Systemeinstellungen aktiviert, reagiert der Mac auf einen Fokus, der auf dem iPhone eingeschaltet wurde.

Bei der Konzeption zu berücksichtigende Einschränkungen: Eine Automatisierung verbleibt auf dem Mac, auf dem Sie sie erstellen. Daher wird eine auf dem MacBook eingerichtete Ordnerautomatisierung nicht auf dem Mac mini ausgelöst, obwohl die Shortcut-Mediathek selbst synchronisiert wird. Richten Sie den Auslöser auf jedem benötigten Gerät ein. Außerdem enthält die Auslöserliste keinen Eintrag für „Webanfrage empfangen“. Überbrücken Sie dies auf Absenderseite mit Skript über SSH ausführen oder mit einem Ordner, den ein Cloud-Synchronisierungsclient überwacht.³¹⁸

Der shortcuts CLI

Seit Monterey enthält macOS eine echte Befehlszeilenschnittstelle für Shortcuts: /usr/bin/shortcuts, dokumentiert in shortcuts(1) und im Benutzerhandbuch von Apple.¹² Sie verfügt über vier Unterbefehle. Alle folgenden Angaben habe ich unter macOS 26.5 überprüft.

shortcuts run <shortcut-name-or-identifier> [-i <input-path> ...] [-o <output-path>] [--output-type <UTI>]
shortcuts list [-f <folder-name>] [--folders] [--show-identifiers]
shortcuts view <shortcut-name>
shortcuts sign [-m <mode>] -i <input> -o <output>

shortcuts run

Führt einen Shortcut anhand seines Namens oder seiner Kennung aus. „Das Ausführen von Shortcuts über die Befehlszeile unterscheidet sich nicht vom Ausführen in der Shortcuts-App“,¹ was Vor- und Nachteile hat: vollständiger Zugriff auf Actions, aber auch sämtliche Berechtigungsabfragen (siehe Berechtigungen).

Das kanonische Beispiel von Apple führt einen Shortcut zum Kombinieren von Bildern für einen Ordner mit JPEG-Dateien aus:¹

shortcuts run "Combine Images" -i ~/Desktop/*.jpg -o ~/Desktop/combined.png

Der CLI hält den Unix-Vertrag auf beiden Seiten ein. Zum Beendigungsstatus heißt es: „Der shortcuts-Befehl wird nach erfolgreicher Ausführung mit 0 und bei einem Fehler mit 1 beendet.“¹ Die Weiterleitung der Ausgabe funktioniert, wenn der Shortcut mit einer Ausgabe endet oder Stoppen und Ausgeben enthält:¹

# Pipe shortcut output onward, typed as RTFD
shortcuts run "Make Meeting Notes" --output-type com.apple.rtfd | ...

# Feed stdin in, capture stdout out
echo "quarterly report" | shortcuts run "Slugify" -i - -o -

Eine dokumentierte Falle: Wenn Sie Text an shortcuts run weiterleiten, wird er als Text übergeben. „Wenn Sie einen Dateipfad über eine Pipe übergeben, wird der Pfad als Text behandelt. Verwenden Sie das Flag -i, damit Ihre Eingabe als Dateipfad behandelt wird.“¹

Eine Gestaltungsregel von Apple sollte zudem in Stein gemeißelt werden: „Am effizientesten sind Shortcuts, die keine Hinweise anzeigen und keine Eingaben anfordern. Fordert ein Shortcut eine Eingabe an, wird der Befehlszeilenprozess angehalten und wartet auf die Benutzereingabe.“¹ Im unbeaufsichtigten Betrieb wird aus dieser Pause ein Hänger. Konzipieren Sie auf den CLI ausgerichtete Shortcuts so, dass sie sämtliche Parameter aus der Eingabe beziehen.

shortcuts list

Listet die Namen der Shortcuts einzeln pro Zeile auf. --folders listet stattdessen Ordner auf; -f <folder> beschränkt die Ausgabe auf einen Ordner („none“ für Shortcuts, die sich in keinem Ordner befinden); --show-identifiers fügt die UUID jedes Shortcuts an.² Kennungen sind für Automatisierungen wichtig: Namen können sich überschneiden und geändert werden, UUIDs nicht. shortcuts run akzeptiert beides.²

shortcuts list --show-identifiers | grep "Deploy"

shortcuts view

Öffnet den angegebenen Shortcut im Shortcuts-Editor.² Das ist am Ende eines Werkzeugablaufs nützlich: Ein Skript, das einen fehlerhaften Shortcut erkennt, kann Sie direkt zu dessen Editor führen.

shortcuts sign

Signiert eine .shortcut-Datei für die Verteilung; zusammen mit den Freigabeformaten wird dies in Teil 5 behandelt.²

Skriptsteuerung der App mit Shortcuts Events

Die dritte programmatische Schnittstelle ist die Skriptschnittstelle. Shortcuts registriert auf dem Mac zwei skriptfähige Ziele: die Shortcuts-App selbst und den oberflächenlosen Hintergrundhelfer Shortcuts Events (Bundle-Kennung com.apple.shortcuts.events, unter macOS 26.5 überprüft).¹¹ Das Skriptwörterbuch nennt den Grund für diese Trennung: „Um einen Shortcut im Hintergrund auszuführen, ohne die Shortcuts-App zu öffnen, richten Sie den Befehl an ‚Shortcuts Events‘ statt an ‚Shortcuts‘.“¹¹

Das Wörterbuch ist klein und stabil. Shortcuts verfügen über die lesbaren Eigenschaften name, subtitle, id, folder, color, icon, accepts input und action count; Ordner besitzen name und id; der einzige Befehl lautet run, mit einem optionalen Parameter with input und einem Ergebnis.¹¹

AppleScript:

tell application "Shortcuts Events"
    run shortcut "Slugify" with input "Quarterly Report Draft"
end tell

JXA:

const se = Application("Shortcuts Events");
const result = se.shortcuts.byName("Slugify").run({withInput: "Quarterly Report Draft"});

Python über ScriptingBridge oder py-applescript greift auf dieselbe Schnittstelle zu; mit ScriptingBridge von PyObjC gibt SBApplication.applicationWithBundleIdentifier_("com.apple.shortcuts.events") das App-Objekt zurück, dessen shortcuts()-Sammlung das oben beschriebene Wörterbuch widerspiegelt.¹¹

Wann Sie diese Schnittstelle dem CLI vorziehen sollten: Sie befinden sich bereits in einem AppleScript-/JXA-Kontext, möchten das Ergebnis des Shortcuts als natives Objekt statt über serialisiertes stdout erhalten oder lösen Ausführungen aus einer App aus, die Apple Events senden kann, aber keine Shell-Befehle starten sollte. Beim ersten Apple Event, das ein Hostprozess an Shortcuts Events sendet, zeigt macOS die standardmäßige Einwilligungsabfrage für Automatisierungen an (Systemeinstellungen → Datenschutz & Sicherheit → Automation). Vor dem unbeaufsichtigten Betrieb muss somit eine weitere Abfrage bestätigt werden.⁶

Das Wörterbuch bietet außerdem Zugriff auf Organisationsebene: Ordner und Shortcut-Metadaten sind lesbar, Ordnerzuweisungen beschreibbar. Dadurch lässt sich die Pflege der Mediathek – etwa Bestandsberichte und Ordnerprüfungen – ohne Zugriff auf die Benutzeroberfläche skripten.¹¹

URL schemes

Shortcuts registriert das URL scheme shortcuts:// sowie das aus der Zeit vor der Übernahme der App stammende, ältere workflow://, was unter macOS 26.5 überprüft wurde.¹⁹ URLs sind der Integrationsweg für andere Apps: Launcher, Notiz-Apps mit Linkfeldern und alle Anwendungen, die eine URL öffnen können. Apple formuliert es eindeutig: „Sie sollten Shortcuts nur dann über eine URL ausführen, wenn Sie eine Integration aus einer anderen App außerhalb von Shortcuts heraus erstellen.“⁹

Einen Shortcut ausführen:⁹

shortcuts://run-shortcut?name=[name]&input=[input]&text=[text]

• name (erforderlich): Prozentkodierter Name des Shortcuts.
• input: entweder text oder clipboard. Bei text wird der Wert des Parameters text zur Eingabe des Shortcuts; bei clipboard wird „der Inhalt der Zwischenablage verwendet“ und text ignoriert.⁹

shortcuts://run-shortcut?name=Lookup%20Goetta&input=text&text=goetta%20is%20great
shortcuts://run-shortcut?name=Add%20to%20Notes&input=clipboard

x-callback-url ergänzt die Verarbeitung von Antworten für Hin- und Rückwege:²⁰

shortcuts://x-callback-url/run-shortcut?name=Calculate%20Tip&input=text&text=24.99&x-success=...&x-error=...&x-cancel=...

• x-success wird bei Erfolg geöffnet, wobei die Textausgabe des Shortcuts als Parameter result angefügt wird.
• x-error wird bei einem Fehler geöffnet und erhält den Parameter errorMessage.
• x-cancel wird geöffnet, wenn der Benutzer den Vorgang abbricht, und stellt keine Ausgabe bereit.²⁰

In der Shell funktioniert open "shortcuts://run-shortcut?...", doch dort sollten Sie shortcuts run vorziehen: Der CLI gibt Beendigungscodes und Ausgaben direkt zurück, statt den Umweg über URL-Rückrufe zu nehmen. Auf dem Mac bleibt das URL scheme vor allem für die App-zu-App-Integration und für Links innerhalb von Dokumenten relevant.

Freigabeformate und Signierung

Shortcuts werden auf zwei Arten weitergegeben, und beide münden in eine Vertrauensentscheidung.⁷

iCloud-Links. In der App: Teilen → Copy iCloud Link. Jeder, der über den Link verfügt, kann den Shortcut zu seiner Bibliothek hinzufügen. Damit sind Links der einfachste Weg für eine öffentliche Veröffentlichung. Behandeln Sie einen Link nach dem Versenden als öffentlich.⁷

Shortcut-Dateien. Datei → Exportieren erzeugt eine .shortcut-Datei (UTI com.apple.shortcut, unter macOS 26.5 verifiziert).¹⁹⁷ Beim Export müssen Sie eine Vertrauensoption auswählen:

• Jeder: „Jeder kann Ihren Shortcut ausführen.“ Apple erhält eine Kopie des Shortcuts zur Validierung.⁷
• Personen, die mich kennen: „Nur Personen, die Sie in ihren Kontakten haben, können Ihren Shortcut ausführen.“ Für diese Prüfung werden Ihre Kontaktinformationen in die Datei eingebettet.⁷

CLI bildet dieselben beiden Modi ab und benennt gemäß shortcuts(1) unter macOS 26.5 den jeweiligen Mechanismus: people-who-know-me „signiert lokal, aber nur Ihre Geräte oder Personen, die Ihre Kontaktinformationen in ihren Kontakten gespeichert haben, können den Shortcut importieren“, während anyone „die Datei über iCloud beglaubigt und jedem den Import des Shortcuts ermöglicht“.²

shortcuts sign -m anyone -i "Deploy Notes.shortcut" -o "Deploy Notes-signed.shortcut"

Dieser Befehl ist die Lösung für die Verteilung in Teams und über CI: Mit -m anyone signierte exportierte Shortcuts lassen sich auch von Empfängern problemlos importieren, die Sie nicht kennen. Da der Modus anyone die Beglaubigung über iCloud vornimmt, sollten Sie eine bei iCloud angemeldete Sitzung und Netzwerkzugriff einplanen, bevor Sie ihn in eine Build-Pipeline integrieren.²

Der Import erfolgt per Drag-and-drop: Doppelklicken Sie auf eine .shortcut-Datei, ziehen Sie sie in die App oder legen Sie sie auf dem Dock-Symbol ab; .workflow-Dateien werden beim Import aus Automator konvertiert.¹⁵ Für Shortcuts, die außerhalb der Gallery geteilt werden, gilt ein von Apple klar formulierter Vorbehalt: „Apple kann die Authentizität oder das Verhalten privat geteilter Shortcuts nicht überprüfen.“⁶ Für Unternehmensgeräte gibt es einen separaten Weg: Apple Configurator unterstützt Shortcuts-Automatisierungen für verwaltete Workflows.²¹

Unter Einstellungen → Erweitert finden Sie außerdem Privates Teilen. Dieser Schalter steuert den Import privat geteilter, auf Kontakte beschränkter Shortcuts und steht neben den Optionen zum Ausführen von Skripten und zum Teilen großer Datenmengen.⁶⁸ Lässt sich ein empfangener Shortcut nicht importieren, liegt es meist an einer unsignierten Datei, einer auf Kontakte beschränkten Datei von jemandem, der nicht in Ihren Kontakten gespeichert ist, oder an deaktiviertem privaten Teilen.

App Intents: So fügen Apps Actions hinzu

Alles bisher im Katalog Aufgeführte stammt von Apple. Die andere Hälfte der Bibliothek kommt aus installierten Apps, und seit 2022 läuft deren Integration über ein einziges Framework: App Intents (iOS 16, macOS 13).¹³ Eine App definiert Typen, die AppIntent entsprechen (ein Verb: Parameter sowie eine perform()-Methode), optional auch AppEntity (ein Substantiv: ein typisierter Inhalt der App mit Kennung und Anzeigedarstellung); den Rest übernimmt das System. Dieselben Definitionen erscheinen in Shortcuts, Siri, Spotlight, Widgets und Apple Intelligence. Shortcuts ist eine Darstellung des Intent-Schemas der App und keine separate Integration.¹³⁴

Für die Darstellung einer App auf dem Mac sind zwei Integrationsstufen relevant:

• Actions: Jeder nicht ausgeblendete Intent erscheint im Shortcuts-Editor unter dem Namen der App als Action und lässt sich mit allem in diesem Leitfaden kombinieren.
• App Shortcuts: In einen AppShortcutsProvider eingebundene Intents werden direkt nach der Installation der App als einsatzbereite Shortcuts bereitgestellt. Benutzer müssen sie nicht selbst zusammenstellen; Siri-Auslösephrasen sind bereits hinterlegt.¹³

Die Reichweite des Frameworks wächst im jährlichen Rhythmus weiter. Die WWDC25-Session über Shortcuts und Spotlight beschreibt die aktuelle Vereinbarung für den Mac direkt: „Solange Ihr Intent unter macOS verfügbar ist, kann er auch in Shortcuts als Teil von Automatisierungen auf dem Mac ausgeführt werden. Dies schließt iOS-Apps ein, die unter macOS installiert werden können.“⁴ Eine iPhone-App, die auf einem Apple-Silicon-Mac läuft, steuert Actions zu Mac-Automatisierungen bei, ohne eine einzige Zeile Mac-spezifischen Codes zu benötigen.

Apples Empfehlungen zur Integration aus derselben Session, zusammengefasst: Stellen Sie Ihre Inhalte als Entitäten mit „Schlüsseleigenschaften, über die ein Modell schlussfolgern können soll“ bereit (die Action Use Model verarbeitet diese), liefern Sie Such-Actions aus, damit Abfragen funktionieren, verwenden Sie Attributed Strings, wo Rich Text sinnvoll ist, und halten Sie Parameterzusammenfassungen gut lesbar.⁴

Aus der Bereitstellung von App Intents in produktiven Apps abgeleitete Gestaltungsempfehlungen für Intent-Autoren:

• Intents sind API. Behandeln Sie Namen, Parameter und Entitätskennungen als verbindlichen Vertrag. Umbenennungen beschädigen die Shortcuts der Benutzer ebenso, wie das Umbenennen eines Endpunkts Clients beeinträchtigt.
• Hintergrundausführung schlägt Vordergrundausführung. Ein Intent, der ausgeführt werden kann, ohne die App zu öffnen, lässt sich in Automatisierungen einbinden. Muss die App dagegen in den Vordergrund wechseln, wird die aktuelle Tätigkeit des Benutzers unterbrochen. Trennen Sie beide Fälle bewusst voneinander.⁴
• Rückgabewerte speisen Pipelines. Gibt ein Intent eine Entität oder einen Wert zurück, können Shortcuts-Benutzer weitere Schritte daran anknüpfen. Gibt er nichts zurück, endet der Ablaufgraph an dieser Stelle.

Diese Website behandelt die Entwicklerseite ausführlich im App-Intents-Themenbereich: App Intents sind Apples neue API für Ihre App (Argumente für die Integration und eine exemplarische Produktionsimplementierung), App Intents 2.0 in iOS 26 (Visual Intelligence, Snippets, verzögert geladene Eigenschaften), App Intents in iOS 27 (lang laufende Hintergrund-Intents, synchronisierbare Entitäten, Spotlight-Neuindizierung) und App Intents im Vergleich zu MCP (wann dieselbe Funktion zusätzlich als Agenten-Tool bereitgestellt werden sollte).

Spotlight und Automatisierungen führen Ihre Intents aus

macOS Tahoe hat die Ausführungsorte für Intents erweitert. Die beiden Neuerungen verändern, welchen Mehrwert die „Integration von App Intents“ auf dem Mac bietet.⁴

Spotlight führt Intents direkt aus. „Ab diesem Jahr können Sie Actions Ihrer App direkt in Spotlight auf dem Mac ausführen. Ihre Apps können Actions in Spotlight anzeigen, indem sie App Intents integrieren – genau wie bei Shortcuts.“⁴ Die Anforderungen sind konkret genug, um sie systematisch zu prüfen:

1. Die Parameterzusammenfassung („eine kurze, natürlichsprachliche Darstellung dessen, was der App Intent tut“) „muss alle erforderlichen Parameter enthalten, die keinen Standardwert haben“.⁴
2. Der Intent darf seine Auffindbarkeit nicht deaktivieren: isDiscoverable mit dem Wert false oder assistantOnly mit dem Wert true entfernt ihn aus Spotlight.⁴
3. Vorschläge und Suchergebnisse stammen aus der Entitätsebene: Implementieren Sie vorgeschlagene Entitäten oder eine aufzählbare Entitätsabfrage für das Auswahlmenü sowie eine Entitäts-Stringabfrage oder indizierte Entitäten für die Suche während der Eingabe.⁴

Automatisierungen führen Intents unbeaufsichtigt aus. Da Automatisierungen in Tahoe Shortcuts und diese wiederum Intents ausführen, kann eine Ordneränderung oder das Einbinden eines Laufwerks jetzt den Intent einer App aufrufen, ohne dass ein Benutzer anwesend ist.⁴ Für Intent-Autoren erhöht dies die im vorherigen Abschnitt beschriebene Messlatte: Ein Intent, der einen Benutzer im Vordergrund voraussetzt, etwa weil er eine Benutzeroberfläche anzeigt oder eine Bestätigung verlangt, scheitert innerhalb einer sofort ausgeführten Automatisierung unbemerkt. Prüfen Sie jeden Intent auf unbeaufsichtigte Ausführung: Was geschieht, wenn niemand auf den Bildschirm schaut?

Zusammen bilden die beiden Neuerungen Apples zurückhaltende architektonische Aussage: Nicht das App-Fenster, sondern der Intent ist die Funktionseinheit auf dem Mac. Spotlight ist der interaktive Aufrufer, Automatisierungen übernehmen unbeaufsichtigte Aufrufe und Shortcuts bilden die Kompositionsebene dazwischen.

Shortcuts aus Skripten und Agents steuern

Shortcuts nimmt in Agent- und Skriptarchitekturen eine besondere Rolle ein: Es bietet externem Code die am wenigsten privilegierte und für Benutzer am besten überprüfbare Möglichkeit, Mac-Funktionen aufzurufen. Ein AI-Agent mit Shell-Zugriff kann die meisten Aufgaben direkt erledigen. Wird ein Vorgang jedoch über einen Shortcut geleitet, ergeben sich Eigenschaften, die eine reine Shell nicht bietet: Der Vorgang wird vom Benutzer definiert und kann von ihm bearbeitet werden, seine Berechtigungen werden für jeden Shortcut einzeln erteilt und lassen sich mit einem Klick widerrufen, und sein Wirkungsbereich ist im Editor sichtbar.⁶ Betrachten Sie die Shortcut-Ebene als einen Funktionskatalog, den der Mensch pflegt und der Agent aufruft.

Bevor irgendetwas davon funktioniert, muss eine zwingende Voraussetzung erfüllt sein: Für CLI ist eine angemeldete GUI-Sitzung erforderlich. Jeder shortcuts-Unterbefehl – einschließlich list – kommuniziert mit einer Hilfsanwendung in der Aqua-Sitzung des Benutzers und schlägt mit „Couldn’t communicate with a helper application“ fehl, wenn keine solche Sitzung vorhanden ist (unter macOS 26.5 verifiziert). Reine SSH-Sitzungen, headless CI-Runner und Launch-Daemons stoßen hier an ihre Grenzen. Führen Sie Agent- und geplante Aufrufe innerhalb einer angemeldeten Benutzersitzung aus – als launchd-Agent, nicht als Daemon.

Der Aufrufvertrag aus Agent-Sicht:¹²

Strukturierte Daten überschreiten die Grenze als Text. In der Praxis eignet sich dafür JSON über stdin/stdout: Der Aufrufer leitet ein JSON-Dokument ein (-i -), der Shortcut parst es mit Get Dictionary from Input (Wörterbuch aus Eingabe abrufen), führt seine Aufgabe aus und endet mit Stop and Output (Stoppen und ausgeben), wodurch ein Wörterbuch als Text zurückgegeben wird.¹¹⁶ So wird der Shortcut zu einer typisierten Funktion mit einem dokumentierten Schema. Dokumentieren Sie in einer README neben der aufrufenden Agent-Konfiguration, welche Ein- und Ausgabestruktur jeder Shortcut erwartet.

Für Zeitüberschreitungen ist der Aufrufer verantwortlich. Da ein Shortcut, der einen Hinweis anzeigt, den CLI-Prozess unbegrenzt anhält,¹ sollte jeder unbeaufsichtigte Aufrufer den Aufruf mit einem Timeout versehen und dessen Ablauf als Fehler behandeln:

# macOS ships no timeout(1); gtimeout comes from `brew install coreutils`
if ! output=$(gtimeout 120 shortcuts run "$UUID" -i - -o - <<<"$payload"); then
  echo "shortcut failed or timed out" >&2
fi
# no-Homebrew alternative using the system perl:
#   perl -e 'alarm shift; exec @ARGV' 120 shortcuts run "$UUID" -i - -o - <<<"$payload"

Bereiten Sie die Berechtigungen vor dem unbeaufsichtigten Betrieb vor. Führen Sie jeden Shortcut einmal interaktiv aus und beantworten Sie seine Abfragen mit Always Allow (Immer erlauben). Vergewissern Sie sich anschließend in einem Terminal, dass der Lauf ohne Abfragen erfolgt, bevor ein Agent oder launchd-Job ihn aufruft.⁶¹ Im Abschnitt zu Berechtigungen erfahren Sie, welche Abfragen Sie damit vorab bestätigen.

Wählen Sie den Einstiegspunkt passend zum Aufrufertyp. Shell-fähige Aufrufer (Agents, CI, launchd-Agents und Makefiles – jeweils innerhalb einer angemeldeten Sitzung) verwenden CLI. Apple-Event-Kontexte (AppleScript-Apps, PyObjC-Daemons) verwenden Shortcuts Events und erhalten native Rückgabewerte.¹¹ Sandboxed- oder reine URL-Kontexte verwenden shortcuts://run-shortcut mit x-callback für Ergebnisse.⁹²⁰ Alle drei führen denselben Shortcut aus; lediglich der Transportweg unterscheidet sich.

Auch die umgekehrte Richtung funktioniert: Shortcuts können als Frontends für Agents dienen. Ein Shortcut mit einem Tastaturkurzbefehl oder einem Platz in der Menüleiste erfasst Kontext (Auswahl, Zwischenablage, aktive App), übergibt ihn an Run Shell Script (Shell-Skript ausführen), das Ihren Agent-CLI aufruft, und zeigt das Ergebnis an. So werden die Eingabeschnittstellen des Betriebssystems zur Benutzeroberfläche für die darunterliegende Tooling-Infrastruktur.¹⁰¹⁷

Berechtigungen und Einwilligung (TCC)

Shortcuts übernimmt das auf Einwilligung ausgerichtete Sicherheitsmodell von macOS. Jeder Automatisierungsfehler, der nicht auf einen Logikfehler zurückzuführen ist, lässt sich letztlich hierher zurückverfolgen. Das Modell besteht aus vier Ebenen. Sobald Sie wissen, welche davon eine Abfrage auslöst, werden die Korrekturen zur Routine.

1. Datenzugriff pro Shortcut. Wenn ein Shortcut erstmals auf eine geschützte Ressource zugreift, fragt Shortcuts: „If a Privacy dialog appears requesting access to data, choose Allow Once, Always Allow, or Don’t Allow.“ Always Allow bedeutet, dass die Shortcuts-App Sie beim nächsten Ausführen des Shortcuts nicht erneut um Zugriff bittet.⁶ Berechtigungen gelten pro Shortcut und Ressource und können eingesehen werden: Im Detailbereich jedes Shortcuts befindet sich ein Privacy-Tab, in dem sich einzelne Berechtigungen widerrufen lassen. Mit „To remove access to all data for this shortcut, click Reset Privacy“ setzen Sie sämtliche Datenzugriffsrechte dieses Shortcuts zurück.⁶

2. Die Skriptsperre. Die fünf Skript-Actions werden nur ausgeführt, wenn Settings → Advanced → Allow Running Scripts aktiviert ist (vollständige Liste oben).⁸ Diese Einstellung gilt global und nicht pro Shortcut. Wenn Sie sie für ein einzelnes Hot-Folder-Skript aktivieren, gilt sie daher auch für jeden importierten Shortcut – ein guter Grund, importierte Shortcuts vor der Ausführung zu prüfen.⁶

3. TCC-Systemabfragen. Actions, die auf geschützte Bereiche des Betriebssystems zugreifen – Files and Folders, Automation/Apple Events zur Steuerung anderer Apps oder Accessibility zur Eingabesteuerung –, lösen die von System Settings → Privacy & Security verwalteten Systemdialoge aus. Diese Berechtigungen werden dem jeweils verantwortlichen Prozess zugeordnet. Deshalb kann sich ein Shortcut in der App, über CLI und innerhalb einer Automatisierung unterschiedlich verhalten: Es handelt sich um verschiedene Startkontexte, denen Berechtigungen separat erteilt werden.⁶

4. Ausführungsrichtlinie der Automatisierung. Die Einstellung Run Immediately oder Run After Confirmation einer Automatisierung legt fest, ob bereits der Auslöser eine menschliche Bestätigung erfordert.¹⁸

Daraus ergeben sich folgende Betriebsregeln:

• Abfragen werden nicht dort angezeigt, wo niemand hinsieht. Für headless Kontexte (SSH-Sitzungen, CI-Runner und Agents) gilt die erste Regel aus dem Abschnitt zu CLI: Ein unbeantworteter Einwilligungsdialog führt zu einer unbegrenzten Pause.¹ Bestätigen Sie die Abfragen vorab interaktiv.
• Reset Privacy ist der Debugger für einen sauberen Ausgangszustand. Verhält sich ein Shortcut nach Änderungen fehlerhaft, können Sie seine Berechtigungen zurücksetzen und ihn erneut interaktiv ausführen, damit alle Abfragen der Reihe nach wieder angezeigt werden.⁶
• Importierte Shortcuts sollten geprüft werden. Apple validiert für „Anyone“ signierte Shortcuts, kann jedoch „cannot verify the authenticity or behavior of shortcuts shared privately“.⁶⁷ Im Privacy-Tab sehen Sie, welche Berechtigungen einem Shortcut erteilt wurden; im Editor erkennen Sie, was er ausführt. Beides zusammen dauert nur eine Minute.

Fehlerbehebung

Kurzreferenz

# Run
shortcuts run "Name"                          # by name
shortcuts run 8F3A...-UUID                    # by identifier (stable)
shortcuts run "Name" -i file.jpg -o out.png   # file in, file out
echo data | shortcuts run "Name" -i - -o -    # stdin → stdout
shortcuts run "Name" --output-type public.plain-text | pbcopy

# Inspect
shortcuts list                                # names
shortcuts list --show-identifiers             # names + UUIDs
shortcuts list --folders                      # folders
shortcuts list -f "Folder"                    # scoped
shortcuts view "Name"                         # open in editor

# Distribute
shortcuts sign -m anyone -i in.shortcut -o out.shortcut
shortcuts sign -m people-who-know-me -i in.shortcut -o out.shortcut

# Exit codes: 0 success, 1 error

-- Background run with result (no app window)
tell application "Shortcuts Events" to run shortcut "Name" with input "payload"

shortcuts://run-shortcut?name=Name&input=text&text=payload
shortcuts://run-shortcut?name=Name&input=clipboard
shortcuts://x-callback-url/run-shortcut?name=Name&x-success=app://ok&x-error=app://fail

Checklisten. Für den unbeaufsichtigten Betrieb geeigneter Shortcut: keine Hinweise oder Ask Each Time-Parameter; Einwilligungen vorab mit Always Allow erteilt; Aufruf über die UUID; der Aufrufer erzwingt einen Timeout; endet mit Stop and Output.¹⁶ Für die Verteilung geeignete Datei: exportiert, mit -m anyone signiert und mit dokumentiertem Eingabevertrag.²⁷

FAQ

Wie führe ich einen Mac-Kurzbefehl aus Terminal aus? shortcuts run "Shortcut Name", optional mit -i für Eingabedateien (oder - für stdin), -o für die Ausgabe (oder - für stdout) und --output-type mit einem Uniform Type Identifier. Bei Erfolg wird der Befehl mit 0 beendet, bei einem Fehler mit 1. Daher lässt er sich wie jedes Unix-Tool mit &&, if und make kombinieren.¹²

Gibt es in macOS endlich Shortcuts-Automationen wie in iOS? Ja, seit macOS Tahoe (26). Zu den Auslösern gehören Tageszeit, Alarm, E-Mail, Nachricht, Ordneränderungen, externe Laufwerke, Displays, Wi‑Fi, Bluetooth, Batteriestand, Ladegerät, Öffnen/Beenden von Apps, Fokus und Stage Manager. Für jeden lässt sich festlegen, ob er sofort oder nach einer Bestätigung ausgeführt wird.³⁴¹⁸

Was bewirkt shortcuts sign -m anyone tatsächlich? Damit wird die Kurzbefehlsdatei über iCloud beglaubigt, sodass sie von allen importiert werden kann. Im Standardmodus people-who-know-me wird sie lokal signiert und der Import auf Ihre eigenen Geräte sowie Personen beschränkt, die Ihre Kontaktinformationen in Contacts haben.²

Wie fügen Apps eigene Aktionen zu Shortcuts auf dem Mac hinzu? Durch die Übernahme des App Intents-Frameworks. Intents erscheinen automatisch als Shortcuts-Aktionen, und ein AppShortcutsProvider liefert ohne Einrichtung App Shortcuts mit der App aus. Auf macOS verfügbare Intents laufen auch über Spotlight und in Tahoe-Automationen, einschließlich Intents aus iOS-Apps, die auf Apple silicon Macs installiert sind.¹³⁴

Wie sollten ein Skript oder ein KI-Agent Kurzbefehle aufrufen? Verwenden Sie das CLI: Ermitteln Sie Kurzbefehle mit shortcuts list --show-identifiers, rufen Sie sie per UUID auf, übergeben Sie JSON über stdin, lesen Sie Ergebnisse aus stdout und versehen Sie jeden Aufruf mit einem Timeout, da ein Kurzbefehl mit Eingabeaufforderung dauerhaft pausiert (macOS enthält kein timeout(1) — verwenden Sie gtimeout aus coreutils oder das Prozess-Timeout Ihrer Programmiersprache). Autorisieren Sie die Berechtigungsabfragen jedes Kurzbefehls vor der unbeaufsichtigten Nutzung interaktiv. Richten Sie sich aus AppleScript-Kontexten an Shortcuts Events, um ihn ohne Öffnen der App auszuführen.¹²¹¹

Kann Shortcuts Automator ersetzen? Für die meisten Workflows ja; Apple bezeichnet Shortcuts als Zukunft der Mac-Automatisierung und hat einen Konverter entwickelt, der die meisten .workflow-Dateien direkt importiert. Automator wird weiterhin mitgeliefert und führt vorhandene Workflows weiter aus. Die Migration ist daher eine Entscheidung, keine Frist.⁵¹⁴¹⁵

Änderungsprotokoll

Referenzen