Automatisation avec Raccourcis sur Mac : la référence du praticien (2026)

TL;DR : Shortcuts est fourni sur tous les Mac depuis macOS Monterey (2021), et macOS Tahoe (26) lui a enfin apporté la fonctionnalité que les adeptes de l’automatisation sur Mac attendaient depuis quatre ans : des automatisations personnelles avec des déclencheurs tels que les modifications de dossiers, la connexion de disques externes, le Wi-Fi, les écrans et le lancement d’apps.³⁴ L’app exécute des raccourcis depuis la barre des menus, Spotlight, les actions rapides de Finder, les raccourcis clavier et un véritable outil en ligne de commande (shortcuts run, list, view, sign).¹² Chaque app peut ajouter des actions au moyen du framework App Intents, qui constitue la même interface que celle sollicitée par Siri, Spotlight et Apple Intelligence.¹³ Les scripts et les agents d’IA pilotent les raccourcis de trois manières : avec CLI, le schéma d’URL shortcuts:// et le processus d’arrière-plan scriptable Shortcuts Events.¹⁹¹¹ Le modèle d’autorisations est le premier élément à maîtriser : les demandes de consentement qui passent inaperçues dans l’app bloquent silencieusement toute exécution sans surveillance.

Lors de la WWDC 2021, Apple a déclaré aux développeurs : « Shortcuts représente l’avenir de l’automatisation sur Mac ».⁵ Cet avenir est arrivé en deux temps. La première moitié a été livrée immédiatement : une app SwiftUI native sous macOS Monterey avec synchronisation iCloud, un outil de migration depuis Automator et une prise en charge complète des scripts shell et d’AppleScript dans l’éditeur.⁵ La seconde moitié a nécessité quatre versions supplémentaires de macOS. Jusqu’à macOS Tahoe, un raccourci sur Mac ne s’exécutait que lorsqu’un élément le sollicitait ; en l’absence de déclencheurs, « automatisation » signifiait qu’il fallait penser à cliquer. Tahoe a comblé cette lacune avec des automatisations personnelles conçues pour le Mac — notamment des déclencheurs liés aux dossiers et aux disques externes —, aux côtés des options déjà connues sous iOS — comme Time of Day (heure de la journée) et Bluetooth —, et a ajouté l’action Use Model, qui place Apple Intelligence au cœur du flux de données d’un raccourci.³⁴

Le résultat mérite d’être étudié sérieusement. En 2026, Shortcuts sur Mac remplit quatre rôles à la fois :

1. Un éditeur sans code proposant des centaines d’actions intégrées, des opérations sur les fichiers à la gestion des fenêtres, en passant par l’IA exécutée sur l’appareil
2. Un moteur d’automatisation doté de déclencheurs liés aux événements système, une nouveauté de macOS Tahoe
3. Un véritable outil en ligne de commande : shortcuts run se comporte comme n’importe quel autre outil Unix, avec stdin, stdout, des codes de sortie et des pipelines¹
4. Un registre d’actions pour chaque app : tout ce qu’une app expose au moyen d’App Intents apparaît automatiquement dans Shortcuts, sur Mac comme sur les autres plateformes¹³⁴

La différence entre un usage occasionnel et une maîtrise approfondie tient à cinq systèmes : le catalogue d’actions (ce qui existe), les déclencheurs d’automatisation (quand les éléments s’exécutent), CLI et les passerelles de script (comment le code appelle Shortcuts), la signature et le partage (comment les raccourcis circulent), ainsi que le modèle d’autorisations (pourquoi les exécutions sans surveillance se bloquent). Chacun fait l’objet d’une partie ci-dessous.

Chaque affirmation de ce guide repose sur la documentation d’Apple, les sessions de la WWDC ou l’examen direct de macOS 26.5 (Shortcuts 7.0) sur la machine utilisée pour sa rédaction. Lorsqu’une information provient directement du système d’exploitation — la page de manuel shortcuts(1), le dictionnaire de scripts de Shortcuts Events ou les actions du framework WorkflowKit —, la citation le précise.

Points clés

• Les automatisations sont la grande nouveauté. macOS Tahoe a apporté les automatisations personnelles au Mac : modifications de dossiers, disques externes, écrans, Wi‑Fi, Bluetooth, Stage Manager, lancement et fermeture d’apps, heure de la journée, et bien plus encore. Chacune peut s’exécuter immédiatement ou après confirmation.³⁴
• Le CLI est bien réel, ce n’est pas un gadget. shortcuts run "Name" -i input -o output prend en charge stdin (-i -), stdout (-o -), les sorties typées via les Uniform Type Identifiers, et renvoie le code 0 en cas de réussite, 1 en cas d’erreur. Utilisez-le dans un pipeline comme n’importe quel outil Unix.¹²
• Trois points d’entrée pour les scripts, une règle. Utilisez le CLI depuis des shells et dans la CI, le URL scheme shortcuts:// uniquement depuis d’autres apps, et Shortcuts Events (AppleScript/ScriptingBridge) lorsque vous devez récupérer des résultats dans un contexte de script sans ouvrir l’app.¹⁹¹¹
• La signature conditionne la distribution. Un fichier .shortcut doit être signé pour circuler : shortcuts sign -m anyone le notarie via iCloud afin que tout le monde puisse l’importer ; le mode par défaut people-who-know-me signe localement et limite l’importation aux personnes qui vous ont dans leurs Contacts.²⁷
• App Intents est la surface destinée aux développeurs. Une app qui fournit des App Intents obtient gratuitement des actions Shortcuts sur le Mac, et ces mêmes intents alimentent Spotlight et les automatisations, y compris pour les apps iOS installées sur des Mac Apple silicon.⁴¹³
• Le consentement est le principal mode d’échec. Shortcuts demande l’autorisation Une fois / Toujours autoriser / Ne pas autoriser pour chaque raccourci et chaque type de données. Les actions qui exécutent des scripts sont derrière un interrupteur global « Allow Running Scripts ». Une exécution sans interface qui rencontre une invite sans réponse attend simplement.¹⁶⁸

Comment utiliser ce guide

Table des matières

Partie 1 : Fondamentaux

1. Qu’est-ce que Shortcuts sur Mac ?
2. Façons d’exécuter un raccourci
3. Shortcuts vs Automator vs AppleScript

Partie 2 : Actions

1. Comment les actions se composent
2. Le catalogue d’actions
3. Actions de script
4. Actions de gestion des fenêtres
5. L’action Use Model

Partie 3 : Automatisations

1. Déclencheurs d’automatisation sur macOS
2. Des modèles d’automatisation efficaces

Partie 4 : La ligne de commande et les URL schemes

1. Le CLI shortcuts
2. Contrôler l’app avec Shortcuts Events
3. URL schemes

Partie 5 : Partage et distribution

1. Formats de partage et signature

Partie 6 : La surface destinée aux développeurs

1. App Intents : comment les apps ajoutent des actions
2. Spotlight et les automatisations exécutent vos intents
3. Piloter Shortcuts depuis des scripts et des agents

Partie 7 : Exploitation et référence

1. Autorisations et consentement (TCC)
2. Dépannage
3. Fiche de référence rapide
4. FAQ
5. Journal des modifications
6. Références

Qu’est-ce que Shortcuts sur Mac ?

Shortcuts est l’app d’automatisation d’Apple : vous enchaînez des actions (étapes à usage unique) dans un raccourci (un workflow enregistré), puis vous l’exécutez par clic, à la voix, par raccourci clavier, déclencheur ou ligne de commande. La définition d’Apple mérite d’être gardée à l’esprit, car elle explique toute la conception : « Une action est l’élément constitutif d’un raccourci. Chaque raccourci comprend une série d’actions, et chaque action est une étape unique qui effectue une fonction particulière. »¹²

L’app est arrivée sur le Mac avec macOS Monterey en 2021, portée depuis iOS, mais écrite presque entièrement en SwiftUI afin qu’une même base de code serve les deux plateformes.⁵ Trois choix de conception de cette première version définissent encore l’expérience sur Mac en 2026 :

• La synchronisation iCloud est activée par défaut. Ouvrez Shortcuts sur un nouveau Mac et votre bibliothèque existante apparaît, synchronisée depuis l’iPhone et l’iPad. Un raccourci créé sur un appareil s’exécute sur les autres, à l’exception des actions propres à une plateforme.⁵¹²
• Les apps fournissent des actions. « Comme sur iOS, n’importe quelle app sur le Mac peut fournir des actions à Shortcuts. »⁵ En 2026, cette chaîne repose sur le framework App Intents, présenté dans la Partie 6.
• Les scripts sont des citoyens de première classe. Monterey fournissait une « prise en charge complète d’AppleScripts et de Shell Scripting », avec de « nouvelles actions, intégrées directement dans Shortcuts, qui vous permettent d’écrire et d’exécuter des scripts directement dans l’éditeur Shortcuts » ; Shortcuts enveloppe donc l’ancienne pile d’automatisation au lieu de la remplacer.⁵

Ce que Monterey ne fournissait pas, c’étaient les déclencheurs. De 2021 à 2024, un raccourci sur Mac ne s’exécutait que lorsqu’un élément l’invoquait. macOS Tahoe (26) a changé cela en 2025 en apportant les automatisations personnelles au Mac, avec des types de déclencheurs conçus spécifiquement pour les workflows de bureau (contenu d’un dossier modifié, disque externe connecté), ainsi que l’ensemble déjà établi sur iOS.³⁴ Tahoe a également ajouté l’action Use Model, qui transmet des données aux modèles Apple Intelligence au milieu d’un raccourci.³⁴

Repères de version :

Dans ce guide, « vérifié sur macOS 26.5 » signifie contrôlé directement dans Shortcuts 7.0 sur le Mac utilisé pour le rédiger.

Façons d’exécuter un raccourci

Shortcuts sur Mac est particulièrement généreux en points d’entrée. Tous les moyens suivants invoquent le même raccourci ; ils diffèrent par l’origine de l’entrée et la destination de la sortie.¹²¹⁰

Deux détails vous feront gagner du temps par la suite. Premièrement, les entrées Quick Action et Services reçoivent la sélection actuelle comme entrée du raccourci ; c’est pourquoi les raccourcis de traitement de fichiers doivent déclarer leurs types d’entrée acceptés (la configuration « Receive » de l’éditeur) plutôt que de supposer qu’il s’agit de texte. Deuxièmement, les trois dernières lignes constituent la surface programmable ; elles ont leurs propres sections, car leurs contrats d’entrée et de sortie diffèrent.

Shortcuts vs Automator vs AppleScript

Les trois systèmes d’automatisation d’Apple sont toujours fournis avec macOS en 2026 (Automator se trouve encore dans /System/Applications, comme vérifié sous macOS 26.5), et chacun conserve son utilité. La distinction qui reste valable est la suivante : Shortcuts constitue la couche d’intégration, AppleScript le langage de contrôle des apps et les scripts shell la couche de calcul. Automator est en mode maintenance : fonctionnel, inchangé et officiellement remplacé par Shortcuts.⁵¹⁴

La voie de migration existe réellement, mais entraîne quelques pertes dans les cas limites. Apple a intégré un convertisseur à Shortcuts : faites glisser un fichier .workflow dans l’app (ou effectuez un Control-clic → Open With → Shortcuts) et « Shortcuts peut convertir la plupart des workflows Automator en raccourcis exécutant les mêmes fonctions, événements et automatisations ».¹⁴¹⁵ « La plupart » est la formulation choisie par Apple et, en pratique, cela signifie que les actions standard sur les fichiers, les images et le texte sont correctement converties ; ce sont surtout les actions Automator tierces peu courantes et les enregistrements Watch Me Do qui perdent en fidélité. Shortcuts conserve même en interne une action nommée Watch Me Do dans le cadre de cette compatibilité (visible dans la table des actions du framework, comme vérifié sous macOS 26.5).¹⁶

Quand aller au-delà de Shortcuts. Le contrôle approfondi d’une app — parcourir les messages de Mail, manipuler les fenêtres Finder par programmation ou piloter des apps dotées de riches dictionnaires de script — reste le domaine d’AppleScript. Le traitement de texte complexe, l’orchestration de API et tout ce que vous écririez de toute façon en Python ou en zsh ont leur place dans un script. La bonne approche consiste à composer plutôt qu’à choisir un camp : un raccourci qui recueille les données d’un déclencheur, les confie à un script shell pour le gros du travail, puis utilise des actions natives pour les notifications et le placement des fichiers tire le meilleur parti de chaque système. La section Actions de script en explique les mécanismes.

Comment les actions se composent

Chaque raccourci est un pipeline. Chaque action reçoit une entrée (souvent la sortie de l’action précédente), accomplit une tâche et produit une sortie. Trois mécanismes rendent ce pipeline expressif :

• Variables magiques. La sortie de chaque action est automatiquement accessible aux actions suivantes sous forme de variable, sans aucune déclaration. Cliquez sur un champ de paramètre, choisissez Select Magic Variable, puis sélectionnez la sortie de n’importe quelle action antérieure. Set Variable et Get Variable permettent de nommer explicitement les variables, tandis qu’Add to Variable sert à constituer des listes (ces trois actions sont intégrées, comme vérifié sous macOS 26.5).¹⁶
• Types de contenu, convertis à la demande. Les actions déclarent ce qu’elles acceptent (fichiers, images, texte, URL, dates). Lorsque les types de sortie et d’entrée diffèrent, Shortcuts effectue une conversion lorsque c’est possible : transmettez une page web à une action de texte et vous obtenez le texte de la page. Le réglage « Receive », situé en haut d’un raccourci dans l’éditeur, indique ce que le raccourci entier accepte depuis Quick Actions, Services ou le paramètre --input-path de CLI.
• Le contrôle de flux sous forme d’actions. If, Repeat, Repeat with Each, Choose from Menu, Wait to Return, Stop This Shortcut et Stop and Output sont des actions ordinaires.¹⁶ Stop and Output est plus important sur Mac que partout ailleurs : il définit ce qu’un raccourci renvoie à la ligne de commande, à un pipe ou à un script appelant.¹

La primitive de composition est Run Shortcut : un raccourci en appelle un autre par son nom, avec une entrée.¹⁶ Les recommandations d’Apple indiquent explicitement que l’imbrication doit passer par l’action et non par des URL schemes : « Si vous souhaitez exécuter un raccourci depuis un autre raccourci, utilisez l’action Run Shortcut plutôt qu’un URL scheme. »⁹ Considérez les raccourcis comme des fonctions : de petits raccourcis à usage unique (normaliser un nom de fichier, publier vers un webhook, redimensionner une image en miniature), composés par un raccourci coordinateur, évoluent bien mieux qu’un monolithe de 60 actions, et chaque élément reste testable indépendamment depuis CLI.

Le catalogue d’actions

La bibliothèque intégrée est vaste : la table des chaînes anglaises du framework WorkflowKit de macOS 26.5 (le framework privé sur lequel repose Shortcuts) répertorie 361 noms d’action distincts.¹⁶ Ce nombre dépasse ce que vous verrez dans l’éditeur : la table comprend des actions réservées à iOS et des intégrations héritées de l’époque où l’app s’appelait Workflow. Voici le catalogue pertinent sur Mac, organisé selon les besoins concrets des personnes qui créent des automatisations. Tous les noms d’action ci-dessous apparaissent mot pour mot dans cette table, comme vérifié sous macOS 26.5.¹⁶

Fichiers et Finder

Système et apps

Web et données

Get Contents of URL, associé aux actions Dictionary, forme un client REST opérationnel : envoyez une requête, analysez le JSON, puis extrayez les valeurs, sans écrire de code. Lorsque les charges utiles deviennent complexes, confiez la tâche à un script shell utilisant curl et jq au lieu de vous battre avec des dictionnaires imbriqués dans l’éditeur.

Texte, images et médias

Calendar, Reminders, Contacts et Notes

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 et leurs équivalents Get Details of… couvrent les apps de productivité.¹⁶ L’association Find/Filter + Get Details constitue le modèle à suivre : interrogez une collection, puis extrayez les champs des résultats correspondants.

Shortcuts, méta-actions et flux

Une remarque sur les méta-automatisations pour la Partie 6 : Get My Shortcuts et Get Details of Shortcut permettent à un raccourci d’énumérer la bibliothèque. Associées à shortcuts list du côté de CLI, ces actions servent à créer des outils autour de votre collection.¹⁶²

Actions de script

Cinq actions relient Shortcuts à la pile d’automatisation traditionnelle, et elles dépendent toutes d’un seul réglage global. Dans Shortcuts → Settings → Advanced, « Allow Running Scripts » doit être activé pour qu’elles puissent s’exécuter ; la description de ce réglage dans l’app indique précisément quelles actions il contrôle : « 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 » (vérifié sur macOS 26.5).⁸¹⁷ La documentation d’Apple ajoute l’avertissement selon lequel l’exécution de raccourcis contenant des scripts peut entraîner une perte de données — ce réglage existe parce que ces cinq actions s’exécutent avec l’ensemble de vos privilèges utilisateur, hors des garde-fous qui encadrent les actions ordinaires.⁸

Run Shell Script

Le cheval de bataille. Vous choisissez le shell, collez le script et définissez la façon dont l’entrée est transmise. Les deux modes d’entrée sont directement issus de la documentation de l’action : « 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. »¹⁷

Conséquences pratiques de ces deux modes :

• Le mode stdin convient au texte et aux fichiers uniques : traitement de type pbpaste, JSON via jq, tout ce qui lit un flux.
• Le mode arguments convient à plusieurs fichiers : chaque élément d’entrée arrive dans "$@", donc for f in "$@"; do ... done traite correctement une sélection Finder, espaces compris.
• La sortie correspond à ce que le script écrit dans stdout et elle est transmise à l’action suivante comme n’importe quelle autre sortie.

Run AppleScript et Run JavaScript for Mac Automation

Les deux incorporent des scripts Open Scripting Architecture dotés d’un point d’entrée on run {input, parameters} (AppleScript) ou d’une fonction run(input, parameters) (JXA). Utilisez-les lorsque la tâche consiste à contrôler une autre app : disposition des fenêtres Finder, règles Mail, tout ce qui possède un dictionnaire de scripts. La valeur renvoyée devient la sortie de l’action.

Run Script Over SSH

Exécute un script shell sur un hôte distant, avec l’hôte, le port, l’utilisateur et l’authentification configurés dans l’action. Son atout majeur est symétrique avec le CLI : un Mac dans votre bureau peut exposer des opérations répétables à toute machine pouvant l’atteindre via SSH, et un raccourci peut envoyer des tâches vers des machines Linux sans quitter l’éditeur Shortcuts.

Run JavaScript on Web Page

Exécute JavaScript sur la page Safari actuelle et renvoie le résultat. Apple la place derrière le réglage des scripts ainsi qu’une demande d’autorisation à chaque exécution, car un JavaScript arbitraire dans le contexte d’une page constitue une surface d’exfiltration de données.⁸

Actions de gestion des fenêtres

Shortcuts offre un contrôle natif des fenêtres sur Mac : Find Windows, Move Window et Resize Window.¹⁶ Elles semblent être des entrées mineures du catalogue, mais deviennent les briques de base de dispositions de fenêtres pilotées au clavier sans outils tiers.

• Find Windows interroge les fenêtres ouvertes (triables et filtrables dans l’éditeur) et produit des objets fenêtre.
• Move Window reçoit une fenêtre et une position. Le résumé de ses paramètres indique « Move ⟨Window⟩ to ⟨Position⟩ », avec une variante personnalisée facultative, « Move ⟨Window⟩ to ⟨Position⟩ ⟨X Coordinate⟩, ⟨Y Coordinate⟩ » (vérifié sur macOS 26.5).¹⁶
• Resize Window reçoit une fenêtre et une cible : « Resize ⟨Window⟩ to ⟨Configuration⟩ », avec une variante personnalisée acceptant des valeurs explicites ⟨Width⟩ × ⟨Height⟩.¹⁶

Les positions de fenêtre intégrées figurent dans la table de chaînes du framework : Full Screen, Left, Right, Top, Bottom, les tiers (Left Third, Middle Third, Right Third), les variantes d’angle (Top/Bottom Leading et Trailing), ainsi qu’un format personnalisé Window Location and Size (vérifié sur macOS 26.5).¹⁶ Combinez Find Windows (fenêtre au premier plan) → Resize Window (Left) avec un raccourci clavier, et vous obtenez une commande de fenêtre à une touche. Split Screen Apps gère le cas de deux apps dans une seule action.¹⁶

L’action Use Model

Nouveauté de macOS Tahoe et action individuelle la plus importante ajoutée par Apple depuis le portage sur Mac : Use Model envoie des données à un modèle Apple Intelligence au milieu d’un raccourci, puis transmet la réponse à l’action suivante.³⁴

Trois choix de modèle, selon la session WWDC d’Apple consacrée à cette fonctionnalité : un grand modèle basé sur serveur dans Private Cloud Compute, le modèle embarqué « for simple requests without network connection », et ChatGPT « for broad world knowledge ».⁴

Trois formes de sortie, dont le choix délibéré constitue la compétence essentielle :⁴

1. Text (y compris le texte enrichi) pour les résumés et les réécritures.
2. Dictionary pour l’extraction structurée ; l’exemple d’Apple consiste à extraire le fournisseur, le montant et la date de factures. La sortie Dictionary rend Use Model composable : les actions en aval lisent des champs au lieu d’analyser du texte.
3. App entities : des objets de contenu provenant d’apps qui les exposent via App Intents. Apple présente cette relation ainsi : « If App Intents are the actions or verbs from your app, App Entities are the nouns »,⁴ et Use Model peut raisonner directement sur ces noms (filtrer ces notes, sélectionner l’événement de calendrier pertinent).

Un bouton Follow Up permet d’itérer sur la réponse du modèle lors de la même exécution.⁴

Une précaution d’ingénierie : la sortie d’un modèle est non déterministe, de sorte qu’une même entrée peut produire des résultats différents d’une exécution à l’autre. Pour les automatisations, privilégiez donc la forme de sortie Dictionary (contrainte par schéma), des prompts courts et ciblés, ainsi qu’une étape de validation (une action If qui vérifie les champs requis) avant que le résultat ne touche des fichiers ou des messages. Traitez Use Model comme un appel réseau instable : utile, mais entouré de vérifications.

Pour la perspective développeur de cette même fonctionnalité (ce que votre app doit exposer pour que Use Model puisse raisonner dessus), consultez la Partie 6 et le groupe App Intents de ce site, à commencer par App Intents Are Apple’s New API to Your App.

Déclencheurs d’automatisation sur macOS

Les automatisations sont des raccourcis auxquels est associé un déclencheur : « exécuter ceci lorsque cela se produit », sans clic nécessaire. Elles sont arrivées sur Mac avec macOS Tahoe, et Apple a conçu des déclencheurs spécifiques au Mac au lieu de porter intégralement la liste d’iOS : « 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. »⁴

Créez-les depuis la zone Automation de l’app Shortcuts. Chaque automatisation associe un déclencheur à un ensemble d’actions et à une décision de politique : Run Immediately (sans interaction, tout l’intérêt de l’automatisation) ou Run After Confirmation (une notification demande d’abord confirmation).³¹⁸ Commencez les nouvelles automatisations avec confirmation, puis passez à l’exécution immédiate une fois que vous leur faites confiance.

Le catalogue des déclencheurs de macOS Tahoe :³⁴¹⁸

Deux évolutions découlent de cette conception. Premièrement, le Mac dispose enfin d’une réponse native d’Apple à « surveiller ce dossier et traiter ce qui y arrive », qui se synchronise et se modifie comme n’importe quel autre raccourci (les Folder Actions d’Automator assuraient la surveillance, mais pas le reste). Deuxièmement, comme les automatisations exécutent des raccourcis, tout ce guide se combine : un déclencheur Folder peut alimenter Run Shell Script ; un déclencheur App peut appeler Use Model ; un déclencheur External Drive peut lancer une tâche SSH.

Modèles d’automatisation efficaces

Des modèles qui résistent à un usage quotidien, entièrement assemblés à partir d’éléments documentés :

Le dossier actif. Déclencheur de dossier sur ~/Inbox → Filter Files (l’extension est pdf) → Extract Text from Image ou Get Text from PDF → Use Model avec une sortie sous forme de dictionnaire (fournisseur, date, total) → Rename File et Move File dans une arborescence d’archivage. Le cas d’usage classique d’Automator, enrichi par une extraction sur l’appareil et un nommage structuré par le modèle.³⁴¹⁶

Le bureau d’accueil. Déclencheur d’écran (connexion d’un écran externe) → Open App pour votre ensemble d’applications professionnelles → Move Window et Resize Window selon votre disposition → Set Focus sur Work. Inversez le processus lors de la déconnexion. Un seul déclencheur reconstitue toute la disposition du bureau sans déplacement manuel.³¹⁶

Le disque d’importation. Déclencheur de disque externe → Get Contents of Folder sur le dossier DCIM de la carte → Filter Files par date → Save File dans un dossier daté → Show Notification avec le nombre de fichiers. Le mode de confirmation est judicieux ici : les disques inattendus ne doivent pas déclencher de copies groupées.³¹⁸

La porte de sortie vers du vrai code. N’importe quel déclencheur → Run Shell Script avec l’entrée transmise sous forme d’arguments → votre script existant. C’est le système de déclenchement qui apporte la valeur ; rien n’impose de placer la logique dans les actions Shortcuts. Une automatisation à deux actions (déclencheur + script) fournit une gestion des événements comparable à launchd, avec en prime une interface, la synchronisation et la gestion du consentement.⁸¹⁷

Contextes liés aux réunions. Déclencheur de mode de concentration (activation du mode Work)¹⁸ → Set Volume, Quit App pour les distractions, Open App pour les notes. Lorsque le partage des modes de concentration entre appareils est activé dans les paramètres système, le Mac réagit à l’activation d’un mode de concentration depuis l’iPhone.

Contraintes à prendre en compte dans la conception : une automatisation réside sur le Mac où vous la créez. Ainsi, une automatisation de dossier configurée sur le MacBook ne se déclenchera pas sur le Mac mini, même si la bibliothèque de raccourcis elle-même est synchronisée (configurez le déclencheur sur chaque machine concernée). Par ailleurs, la liste des déclencheurs ne comporte aucune entrée « réception d’une requête web » (comblez cette lacune avec Run Script Over SSH côté expéditeur, ou avec un dossier surveillé par un client de synchronisation cloud).³¹⁸

Le CLI de Shortcuts

Depuis Monterey, macOS intègre une véritable interface en ligne de commande pour Shortcuts : /usr/bin/shortcuts, documentée dans shortcuts(1) et dans le guide de l’utilisateur d’Apple.¹² Elle comporte quatre sous-commandes. J’ai vérifié tout ce qui suit sous macOS 26.5.

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

Exécute un raccourci à partir de son nom ou de son identifiant. « Exécuter des raccourcis depuis la ligne de commande ne diffère en rien de leur exécution dans l’app Shortcuts »¹, avec les avantages comme les inconvénients que cela implique : accès à toutes les actions et affichage de toutes les demandes d’autorisation (consultez Autorisations).

L’exemple canonique d’Apple exécute un raccourci de combinaison d’images sur un dossier de fichiers JPEG :¹

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

Le CLI respecte le contrat Unix aux deux extrémités. État de sortie : « La commande shortcuts renvoie 0 en cas d’exécution réussie, ou 1 en cas d’erreur. »¹ Le chaînage de la sortie fonctionne lorsque le raccourci se termine par une sortie ou contient Stop and Output :¹

# 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 -

Un piège documenté : le texte transmis vers shortcuts run par un pipe est fourni comme du texte. « Lorsque vous transmettez un chemin de fichier par un pipe, ce chemin est traité comme du texte. Utilisez l’option -i pour que votre entrée soit traitée comme un chemin de fichier. »¹

Autre règle de conception d’Apple qui mérite d’être gravée dans le marbre : « les raccourcis les plus efficaces sont ceux qui n’affichent aucune alerte et ne demandent aucune saisie. Lorsqu’un raccourci demande une saisie, le processus en ligne de commande se met en pause dans l’attente de l’utilisateur. »¹ Dans tout environnement sans interface, cette pause équivaut à un blocage. Concevez les raccourcis destinés au CLI de façon à recevoir tous leurs paramètres par l’entrée.

shortcuts list

Répertorie les noms des raccourcis, un par ligne. --folders répertorie les dossiers à la place ; -f <folder> limite la liste à un dossier (« none » pour les raccourcis qui ne se trouvent dans aucun dossier) ; --show-identifiers ajoute l’UUID de chaque raccourci.² Les identifiants sont importants pour l’automatisation : les noms peuvent entrer en conflit et être renommés, contrairement aux UUID. shortcuts run accepte les deux.²

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

shortcuts view

Ouvre le raccourci indiqué dans l’éditeur de Shortcuts.² Pratique à la fin d’une chaîne d’outils : un script qui détecte l’échec d’un raccourci peut vous conduire directement à son éditeur.

shortcuts sign

Signe un fichier .shortcut en vue de sa distribution ; ce sujet est traité avec les formats de partage dans la Partie 5.²

Contrôler l’app avec Shortcuts Events

La troisième interface programmable est l’interface de script. Sur Mac, Shortcuts enregistre deux cibles scriptables : l’app Shortcuts elle-même et un utilitaire d’arrière-plan sans interface, Shortcuts Events (identifiant de bundle com.apple.shortcuts.events, vérifié sous macOS 26.5).¹¹ Le dictionnaire de script explique directement cette séparation : « Pour exécuter un raccourci en arrière-plan sans ouvrir l’app Shortcuts, adressez-vous à “Shortcuts Events” plutôt qu’à “Shortcuts”. »¹¹

Le dictionnaire est concis et stable. Les raccourcis disposent des propriétés accessibles en lecture name, subtitle, id, folder, color, icon, accepts input et action count ; les dossiers possèdent name et id ; l’unique commande est run, avec un paramètre facultatif with input et un résultat.¹¹

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 via ScriptingBridge ou py-applescript cible la même interface ; avec ScriptingBridge de PyObjC, SBApplication.applicationWithBundleIdentifier_("com.apple.shortcuts.events") renvoie l’objet de l’app dont la collection shortcuts() reflète le dictionnaire ci-dessus.¹¹

Quand la préférer au CLI : lorsque vous vous trouvez déjà dans un contexte AppleScript/JXA, que vous souhaitez récupérer le résultat du raccourci sous forme d’objet natif plutôt que via stdout sérialisé, ou que vous lancez des exécutions depuis une app capable d’envoyer des Apple Events, mais qui ne devrait pas appeler le shell. Le premier Apple Event envoyé à Shortcuts Events par un processus hôte déclenche la demande de consentement standard de macOS pour l’automatisation (Paramètres système → Confidentialité et sécurité → Automatisation), une autorisation supplémentaire à accorder avant toute exécution sans surveillance.⁶

Le dictionnaire fournit également un accès permettant d’organiser la bibliothèque (les dossiers et les métadonnées des raccourcis sont accessibles en lecture, et l’affectation aux dossiers en écriture). Vous pouvez ainsi scripter les tâches de maintenance de la bibliothèque, comme les rapports d’inventaire et les audits de dossiers, sans toucher à l’interface.¹¹

URL schemes

Shortcuts enregistre le URL scheme shortcuts:// (ainsi que l’ancien workflow://, hérité de l’app avant son acquisition, vérifié sous macOS 26.5).¹⁹ Les URL constituent la voie d’intégration destinée aux autres apps : lanceurs, apps de prise de notes comportant des champs de lien et tout logiciel capable d’ouvrir une URL. La recommandation d’Apple est sans équivoque : « Vous ne devriez exécuter des raccourcis au moyen d’une URL que dans le cadre d’une intégration depuis une autre app, extérieure à Shortcuts. »⁹

Exécuter un raccourci :⁹

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

• name (obligatoire) : nom du raccourci encodé en pourcentage.
• input : text ou clipboard. Avec text, la valeur du paramètre text devient l’entrée du raccourci ; avec clipboard, « le contenu du presse-papiers est utilisé » et text est ignoré.⁹

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

x-callback-url ajoute la gestion des réponses pour les allers-retours :²⁰

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

• x-success s’ouvre en cas de réussite, avec la sortie textuelle du raccourci ajoutée sous forme de paramètre result.
• x-error s’ouvre en cas d’échec, avec un paramètre errorMessage.
• x-cancel s’ouvre si l’utilisateur annule l’opération et ne fournit aucune sortie.²⁰

Depuis le shell, open "shortcuts://run-shortcut?..." fonctionne, mais préférez-y shortcuts run : le CLI renvoie directement les codes de sortie et le résultat, sans passer par des rappels d’URL. Sur Mac, le créneau restant de ce schéma concerne l’intégration entre apps et les liens intégrés aux documents.

Formats de partage et signature

Les Shortcuts circulent de deux manières, chacune impliquant une décision de confiance.⁷

Liens iCloud. Dans l’app : partager → Copy iCloud Link (Copier le lien iCloud). Toute personne disposant du lien peut ajouter le raccourci à sa bibliothèque, ce qui en fait le moyen le plus simple de le publier largement. Considérez un lien comme public dès son envoi.⁷

Fichiers de raccourci. File → Export (Fichier → Exporter) produit un fichier .shortcut (UTI com.apple.shortcut, vérifié sous macOS 26.5).¹⁹⁷ Lors de l’exportation, vous devez choisir le niveau de confiance :

• Anyone (Tout le monde) : « Tout le monde peut exécuter votre raccourci. » Apple reçoit une copie du raccourci à des fins de validation.⁷
• People Who Know Me (Personnes qui me connaissent) : « Seules les personnes qui vous ont dans leurs contacts pourront exécuter votre raccourci. » Vos coordonnées sont intégrées au fichier pour permettre cette vérification.⁷

La CLI reprend ces deux mêmes modes et précise leur mécanisme, selon shortcuts(1) sous macOS 26.5 : people-who-know-me « effectue une signature locale, mais seuls vos appareils ou les utilisateurs qui ont vos coordonnées dans leurs contacts pourront importer le raccourci », tandis que anyone « effectue une notarisation via iCloud et permet à tout le monde d’importer le raccourci ».²

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

Cette commande répond aux besoins de distribution des équipes et des systèmes CI : les raccourcis exportés et signés avec -m anyone peuvent être importés sans problème par des destinataires qui ne vous connaissent pas. Puisque le mode anyone effectue la notarisation par l’intermédiaire d’iCloud, prévoyez une session connectée à iCloud et un accès réseau avant de l’intégrer à un pipeline de build.²

L’importation s’effectue par glisser-déposer : double-cliquez sur un fichier .shortcut, faites-le glisser dans l’app ou déposez-le sur l’icône du Dock ; les fichiers .workflow sont convertis depuis Automator lors de l’importation.¹⁵ Apple formule clairement la mise en garde qui accompagne les Shortcuts partagés en dehors de Gallery : « Apple ne peut pas vérifier l’authenticité ni le comportement des raccourcis partagés de manière privée. »⁶ Les parcs informatiques d’entreprise disposent d’une voie distincte : Apple Configurator prend en charge les automatisations Shortcuts pour les workflows gérés.²¹

Settings → Advanced (Paramètres → Avancés) contient également Private Sharing (Partage privé), l’option qui régit l’importation des raccourcis partagés de manière privée et réservés aux contacts, ainsi que Allow Running Scripts (Autoriser l’exécution de scripts) et Allow Sharing Large Amounts of Data (Autoriser le partage de grandes quantités de données).⁶⁸ Lorsqu’un raccourci reçu ne peut pas être importé, la cause est généralement l’une des suivantes : le fichier n’est pas signé, il est réservé aux contacts et provient d’une personne absente de vos contacts, ou Private Sharing est désactivé.

App Intents : comment les apps ajoutent des actions

Jusqu’ici, tout ce qui figure dans le catalogue provient d’Apple. L’autre moitié de la bibliothèque est fournie par les apps installées et, depuis 2022, repose sur un seul framework : App Intents (iOS 16, macOS 13).¹³ Une app définit des types conformes à AppIntent (un verbe : des paramètres accompagnés d’une méthode perform()), éventuellement à AppEntity (un nom : un élément typé du contenu de l’app, doté d’un identifiant et d’une représentation visuelle), puis le système prend le relais. Ces mêmes définitions apparaissent dans Shortcuts, Siri, Spotlight, les widgets et Apple Intelligence ; Shortcuts constitue une projection du schéma d’intentions de l’app, et non une intégration distincte.¹³⁴

Deux niveaux d’adoption déterminent la manière dont une app apparaît sur le Mac :

• Actions : chaque intention non masquée apparaît comme une action dans l’éditeur Shortcuts sous le nom de l’app et peut être combinée avec tout ce que présente ce guide.
• App Shortcuts : les intentions encapsulées dans un AppShortcutsProvider sont livrées sous forme de raccourcis prêts à l’emploi dès l’installation de l’app, sans configuration par l’utilisateur, et sont associées à des phrases de déclenchement Siri.¹³

La portée du framework continue de s’élargir au rythme des mises à jour annuelles. La session WWDC25 consacrée à Shortcuts et Spotlight énonce directement les modalités actuelles sur Mac : « Dès lors que votre intention est disponible sous macOS, elle peut également être utilisée dans Shortcuts afin de s’exécuter dans le cadre d’automatisations sur Mac. Cela inclut les apps iOS pouvant être installées sous macOS. »⁴ Une app iPhone exécutée sur un Mac avec puce Apple fournit ainsi des actions aux automatisations Mac sans nécessiter la moindre ligne de code propre au Mac.

Voici, en résumé, les recommandations d’Apple issues de cette même session : exposez votre contenu sous forme d’entités dotées de « propriétés clés sur lesquelles un modèle pourrait raisonner » (l’action Use Model les exploite), fournissez des actions de recherche pour permettre les requêtes, utilisez des chaînes attribuées lorsque le texte enrichi est pertinent et veillez à la lisibilité des résumés de paramètres.⁴

Conseils de conception destinés aux auteurs d’intentions, tirés du déploiement d’App Intents dans des apps en production :

• Les intentions sont des API. Considérez les noms, les paramètres et les identifiants d’entités comme un contrat ; les renommer casse les raccourcis des utilisateurs, tout comme le changement de nom d’un endpoint casse les clients.
• L’arrière-plan prime sur le premier plan. Une intention pouvant s’exécuter sans ouvrir l’app s’intègre aux automatisations ; une intention qui doit passer au premier plan interrompt l’activité en cours de l’utilisateur. Séparez-les délibérément.⁴
• Les valeurs renvoyées alimentent les pipelines. Une intention qui renvoie une entité ou une valeur offre aux utilisateurs de Shortcuts un élément à enchaîner ; une intention qui ne renvoie rien constitue une impasse dans le graphe.

Ce site aborde en détail le volet destiné aux développeurs dans la série consacrée à App Intents : App Intents est la nouvelle API d’Apple pour votre app (les raisons de l’adopter et une présentation détaillée de son utilisation en production), App Intents 2.0 dans iOS 26 (Visual Intelligence, snippets et propriétés différées), App Intents dans iOS 27 (intentions de longue durée en arrière-plan, entités synchronisables et réindexation de Spotlight) et App Intents face à MCP (dans quels cas la même fonctionnalité doit également devenir un outil pour agent).

Spotlight et les automatisations exécutent vos intentions

macOS Tahoe a étendu les contextes dans lesquels les intentions s’exécutent, et ces deux nouveautés renforcent les avantages de l’adoption d’App Intents sur Mac.⁴

Spotlight exécute les intentions directement dans son interface. « Cette année, vous pouvez désormais exécuter les actions de votre app directement depuis Spotlight sur Mac. Vos apps peuvent afficher des actions dans Spotlight en adoptant App Intents, comme elles le font déjà pour Shortcuts. »⁴ Les exigences sont suffisamment précises pour servir de critères d’audit :

1. Le résumé des paramètres (« une courte formulation en langage naturel de ce que fait l’intention de l’app ») « doit contenir tous les paramètres obligatoires qui n’ont pas de valeur par défaut ».⁴
2. L’intention ne doit pas désactiver sa découvrabilité : définir isDiscoverable sur false ou assistantOnly sur true la retire de Spotlight.⁴
3. Les suggestions et la recherche proviennent de la couche d’entités : implémentez des entités suggérées ou une requête d’entités énumérables pour le sélecteur, ainsi qu’une requête textuelle d’entités ou des entités indexées pour la recherche au fil de la saisie.⁴

Les automatisations exécutent les intentions sans intervention. Puisque les automatisations de Tahoe exécutent des Shortcuts, lesquels exécutent des intentions, la modification d’un dossier ou le montage d’un disque peut désormais invoquer l’intention d’une app sans qu’aucun utilisateur soit présent.⁴ Pour les auteurs d’intentions, cela relève le niveau d’exigence défini dans la section précédente : une intention qui suppose la présence d’un utilisateur au premier plan — en affichant une interface ou en demandant une confirmation — échoue silencieusement au sein d’une automatisation Run Immediately. Vérifiez chaque intention pour l’exécution sans intervention : que se passe-t-il lorsque personne ne regarde l’écran ?

Ensemble, ces deux fonctionnalités expriment discrètement la vision architecturale d’Apple : sur Mac, l’unité fonctionnelle n’est pas la fenêtre de l’app, mais l’intention. Spotlight en est l’appelant interactif, les automatisations l’appelant sans intervention et Shortcuts la couche de composition qui les relie.

Piloter Shortcuts depuis des scripts et des agents

Shortcuts occupe une place bien précise dans les architectures d’agents et de scripts : c’est le moyen qui requiert le moins de privilèges et offre à l’utilisateur la meilleure visibilité pour permettre à du code externe d’exploiter les capacités du Mac. Un agent d’IA disposant d’un accès au shell peut effectuer directement la plupart des opérations, mais passer par un raccourci offre des propriétés que le shell brut n’a pas : l’opération est définie et modifiable par l’utilisateur, ses autorisations sont accordées par raccourci et révocables en un clic, et l’étendue de son impact est visible dans l’éditeur.⁶ Considérez la couche des raccourcis comme un catalogue de capacités géré par l’utilisateur et appelé par l’agent.

Une condition incontournable doit être remplie : le CLI nécessite une session graphique ouverte par un utilisateur. Chaque sous-commande shortcuts — y compris list — communique avec une application auxiliaire dans la session Aqua de l’utilisateur et échoue avec le message « Couldn’t communicate with a helper application » lorsqu’aucune session de ce type n’existe (vérifié sous macOS 26.5). Les sessions uniquement SSH, les exécuteurs CI sans interface graphique et les daemons de lancement se heurtent à cette limite ; exécutez les appels des agents et les tâches planifiées dans une session utilisateur ouverte — avec un agent launchd, et non un daemon.

Le contrat d’appel, en termes d’agent :¹²

Les données structurées franchissent la frontière sous forme de texte. Le modèle fonctionnel consiste à utiliser JSON sur stdin/stdout : l’appelant transmet un document JSON (-i -), le raccourci l’analyse avec Get Dictionary from Input, effectue son travail, puis se termine avec Stop and Output pour renvoyer un dictionnaire sous forme de texte.¹¹⁶ Le raccourci devient ainsi une fonction typée dotée d’un schéma documenté ; conservez un README décrivant la structure d’entrée et de sortie attendue de chaque raccourci à côté de la configuration de l’agent qui l’appelle.

La gestion des délais d’expiration incombe à l’appelant. Comme un raccourci affichant une alerte suspend indéfiniment le processus CLI,¹ chaque appelant sans surveillance doit imposer un délai d’expiration et considérer son dépassement comme un échec :

# 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"

Préautorisez les accès avant toute exécution sans surveillance. Exécutez chaque raccourci une première fois de manière interactive et répondez Always Allow aux invites ; vérifiez ensuite depuis un terminal que l’exécution ne déclenche plus aucune invite avant de confier l’appel à un agent ou à une tâche launchd.⁶¹ La section sur les autorisations explique les accès que vous préautorisez.

Choisissez le point d’entrée selon le type d’appelant. Les appelants capables d’utiliser le shell (agents, CI, agents launchd, Makefiles — tous au sein d’une session utilisateur ouverte) emploient le CLI. Les contextes Apple Event (applications AppleScript, daemons PyObjC) utilisent Shortcuts Events et obtiennent des valeurs de retour natives.¹¹ Les contextes en bac à sable ou limités aux URL utilisent shortcuts://run-shortcut avec x-callback pour récupérer les résultats.⁹²⁰ Les trois exécutent le même raccourci ; seul le transport diffère.

Le sens inverse fonctionne également : les raccourcis peuvent servir d’interfaces aux agents. Un raccourci associé à un raccourci clavier ou placé dans la barre des menus peut recueillir le contexte (sélection, presse-papiers, application au premier plan), le transmettre à Run Shell Script pour appeler le CLI de votre agent, puis afficher le résultat — les surfaces de saisie du système d’exploitation deviennent ainsi l’interface utilisateur des outils sous-jacents.¹⁰¹⁷

Autorisations et consentement (TCC)

Shortcuts hérite du modèle de sécurité de macOS fondé sur le consentement préalable, et tout échec d’automatisation qui ne relève pas d’une erreur logique finit par trouver son origine ici. Le modèle comporte quatre niveaux ; identifiez celui qui affiche l’invite et les corrections deviennent mécaniques.

1. Consentement aux données par raccourci. Lorsqu’un raccourci accède pour la première fois à une ressource protégée, Shortcuts demande : « If a Privacy dialog appears requesting access to data, choose Allow Once, Always Allow, or Don’t Allow. » Always Allow signifie que « the Shortcuts app won’t ask you for access the next time you run the shortcut. »⁶ Les autorisations sont accordées par raccourci et par ressource, et peuvent être consultées : le volet des détails de chaque raccourci comprend un onglet Privacy permettant de révoquer les autorisations individuellement, tandis que « To remove access to all data for this shortcut, click Reset Privacy. »⁶

2. L’autorisation des scripts. Les cinq actions de script ne s’exécutent que si Settings → Advanced → Allow Running Scripts est activé (liste exacte ci-dessus).⁸ Ce paramètre est global, et non propre à chaque raccourci ; l’activer pour un script de dossier surveillé l’active pour tous les raccourcis importés, d’où l’intérêt de lire ces derniers avant de les exécuter.⁶

3. Invites TCC du système. Les actions qui accèdent à des zones protégées du système d’exploitation (Files and Folders, Automation/Apple Events pour piloter d’autres applications, Accessibility pour contrôler les entrées) déclenchent les boîtes de dialogue système gérées dans System Settings → Privacy & Security. Celles-ci sont liées au processus responsable, ce qui explique qu’un raccourci puisse se comporter différemment dans l’application, depuis le CLI ou au sein d’une automatisation : il s’agit de contextes de lancement distincts, disposant chacun de leurs propres autorisations.⁶

4. Politique d’exécution des automatisations. Le paramètre Run Immediately ou Run After Confirmation de chaque automatisation détermine si le déclenchement lui-même nécessite une intervention humaine.¹⁸

Règles opérationnelles qui en découlent :

• Les invites ne s’affichent pas utilement lorsque personne ne les surveille. Les contextes sans interface graphique (sessions SSH, exécuteurs CI, agents) héritent de la première règle de la section sur le CLI : une boîte de dialogue de consentement sans réponse provoque une suspension indéfinie.¹ Préautorisez les accès de manière interactive.
• Reset Privacy constitue la méthode de débogage pour repartir de zéro. Lorsqu’un raccourci se comporte mal après des modifications, réinitialisez ses autorisations, puis relancez-le de manière interactive afin de faire réapparaître chaque invite dans l’ordre.⁶
• Les raccourcis importés méritent d’être examinés. Apple valide les raccourcis signés avec « Anyone », mais « cannot verify the authenticity or behavior of shortcuts shared privately. »⁶⁷ L’onglet Privacy indique les autorisations accordées à un raccourci ; l’éditeur montre ce qu’il fait. Ces deux vérifications ne prennent qu’une minute.

Résolution des problèmes

Fiche de référence rapide

# 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

Listes de vérification. Raccourci prêt pour une exécution sans surveillance : aucune alerte ni aucun paramètre Ask Each Time ; consentements préautorisés avec Always Allow ; appel par UUID ; délai d’expiration imposé par l’appelant ; terminaison avec Stop and Output.¹⁶ Fichier prêt à être distribué : exporté, signé avec -m anyone, contrat d’entrée documenté.²⁷

FAQ

Comment exécuter un raccourci Mac depuis Terminal ? shortcuts run "Shortcut Name", éventuellement avec -i pour les fichiers d’entrée (ou - pour stdin), -o pour la sortie (ou - pour stdout), et --output-type avec un Uniform Type Identifier. La commande renvoie 0 en cas de réussite et 1 en cas d’erreur ; elle se combine donc avec &&, if et make comme n’importe quel outil Unix.¹²

macOS dispose-t-il enfin d’automatisations Shortcuts comme iOS ? Oui, depuis macOS Tahoe (26). Les déclencheurs incluent Heure de la journée, Alarme, E-mail, Message, modifications de dossier, disque externe, écran, Wi-Fi, Bluetooth, niveau de batterie, chargeur, ouverture/quitter d’app, Focus et Stage Manager, chacun pouvant être configuré pour s’exécuter immédiatement ou après confirmation.³⁴¹⁸

Que fait réellement shortcuts sign -m anyone ? Cette commande notarise le fichier de raccourci via iCloud afin que n’importe qui puisse l’importer. Le mode par défaut, people-who-know-me, signe localement et limite l’importation à vos propres appareils et aux personnes dont les coordonnées figurent dans Contacts.²

Comment les apps ajoutent-elles leurs propres actions à Shortcuts sur Mac ? En adoptant le framework App Intents. Les intents apparaissent automatiquement comme actions Shortcuts, et un AppShortcutsProvider fournit des App Shortcuts prêts à l’emploi avec l’app. Les intents disponibles sur macOS s’exécutent aussi depuis Spotlight et dans les automatisations Tahoe, y compris les intents d’apps iOS installées sur les Mac Apple silicon.¹³⁴

Comment un script ou un agent IA doit-il invoquer des raccourcis ? Utilisez le CLI : découvrez-les avec shortcuts list --show-identifiers, invoquez-les par UUID, transmettez JSON via stdin, lisez les résultats depuis stdout et encapsulez chaque appel dans un délai d’expiration, car un raccourci qui affiche une invite restera bloqué indéfiniment (macOS ne fournit pas timeout(1) ; utilisez gtimeout de coreutils ou le délai d’expiration de processus de votre langage). Autorisez au préalable de manière interactive les invites d’autorisation de chaque raccourci avant toute utilisation sans surveillance. Depuis des contextes AppleScript, ciblez Shortcuts Events pour exécuter sans ouvrir l’app.¹²¹¹

Shortcuts peut-il remplacer Automator ? Pour la plupart des workflows, oui ; Apple présente Shortcuts comme l’avenir de l’automatisation sur Mac et a créé un convertisseur qui importe directement la plupart des fichiers .workflow. Automator est toujours fourni et exécute toujours les workflows existants ; la migration est donc un choix, pas une échéance.⁵¹⁴¹⁵

Journal des modifications

Références