blake@mac:~$ shortcuts run "shortcuts-guide"

Automatización con Atajos de Mac: la referencia para profesionales (2026)

# Atajos de Apple en macOS: el catálogo de acciones, los activadores de automatización, la CLI de atajos, la firma, App Intents y la ejecución de atajos desde scripts y agentes.

author: words: 12210 read_time: 57m updated: 2026-08-17 01:40
$ less shortcuts.md

TL;DR: Shortcuts viene incluido en todas las Mac desde macOS Monterey (2021), y macOS Tahoe (26) finalmente incorporó la pieza que quienes automatizan tareas en la Mac esperaron durante cuatro años: automatizaciones personales con activadores como cambios en carpetas, unidades externas, Wi-Fi, pantallas y apertura de apps.34 La app ejecuta atajos desde la barra de menús, Spotlight, las acciones rápidas de Finder, atajos de teclado y una verdadera herramienta de línea de comandos (shortcuts run, list, view, sign).12 Cualquier app puede agregar acciones mediante el framework App Intents, que es la misma interfaz que utilizan Siri, Spotlight y Apple Intelligence.13 Los scripts y agentes de IA controlan los atajos de tres maneras: mediante CLI, el URL scheme shortcuts:// y el proceso en segundo plano programable Shortcuts Events.1911 El modelo de permisos es lo primero que debes aprender: las solicitudes de consentimiento que no aparecen al ejecutar un atajo desde la app pueden bloquear silenciosamente una ejecución desatendida.

Apple les dijo a los desarrolladores que «Shortcuts es el futuro de la automatización en la Mac» durante la WWDC 2021.5 Ese futuro llegó en dos partes. La primera apareció de inmediato: una app nativa en SwiftUI para macOS Monterey con sincronización mediante iCloud, una herramienta de migración de Automator y compatibilidad total con scripts de shell y AppleScript dentro del editor.5 La segunda tardó cuatro versiones más de macOS. Hasta macOS Tahoe, un atajo de la Mac solo se ejecutaba cuando algo lo solicitaba; no había activadores, así que la «automatización» consistía en acordarse de hacer clic. Tahoe cerró esa brecha con automatizaciones personales diseñadas para la Mac —con activadores para carpetas y unidades externas— junto con las conocidas opciones de iOS —como Hora del día y Bluetooth—, además de agregar una acción Use Model que sitúa Apple Intelligence en medio del flujo de datos de un atajo.34

El resultado es un sistema que vale la pena aprender a fondo. En 2026, Shortcuts en la Mac cumple cuatro funciones a la vez:

  1. Un editor sin código con cientos de acciones integradas, desde operaciones con archivos y administración de ventanas hasta IA en el dispositivo
  2. Un motor de automatización con activadores basados en eventos del sistema, incorporados en macOS Tahoe
  3. Una herramienta de línea de comandos de pleno derecho: shortcuts run se comporta como cualquier otra herramienta de Unix, con stdin, stdout, códigos de salida y tuberías1
  4. Un registro de acciones para todas las apps: todo lo que una app expone mediante App Intents aparece automáticamente en Shortcuts, tanto en la Mac como en las demás plataformas134

La diferencia entre un uso ocasional y uno avanzado se reduce a cinco sistemas: el catálogo de acciones —qué existe—, los activadores de automatización —cuándo se ejecutan las tareas—, CLI y los puentes para scripts —cómo se invocan desde el código—, la firma y el uso compartido —cómo se distribuyen los atajos— y el modelo de permisos —por qué se bloquean las ejecuciones desatendidas—. Cada uno tiene su propia sección a continuación.

Todas las afirmaciones de esta guía se basan en la documentación de Apple, las sesiones de la WWDC o la inspección directa de macOS 26.5 (Shortcuts 7.0) en la computadora donde se escribió. Cuando un dato proviene del propio sistema operativo —la página del manual de shortcuts(1), el diccionario de scripting de Shortcuts Events o las acciones del framework WorkflowKit—, la cita así lo indica.


Puntos clave

  • Las automatizaciones son el gran titular. macOS Tahoe incorporó automatizaciones personales al Mac: cambios en carpetas, unidades externas, pantallas, Wi‑Fi, Bluetooth, Stage Manager, apertura o cierre de apps, hora del día y más; cada una puede ejecutarse de inmediato o después de confirmación.34
  • El CLI es real, no un juguete. shortcuts run "Name" -i input -o output admite stdin (-i -), stdout (-o -), resultados tipados mediante Uniform Type Identifiers y devuelve 0 si tiene éxito, 1 si hay un error. Úsalo en una tubería como cualquier herramienta Unix.12
  • Tres puntos de entrada para scripts, una regla. Usa el CLI desde shells y CI, el URL scheme shortcuts:// solo desde otras apps y Shortcuts Events (AppleScript/ScriptingBridge) cuando necesites recuperar resultados en un contexto de scripting sin abrir la app.1911
  • La firma habilita la distribución. Un archivo .shortcut debe estar firmado para compartirse: shortcuts sign -m anyone lo certifica mediante iCloud para que cualquiera pueda importarlo; el modo predeterminado people-who-know-me lo firma localmente y limita la importación a personas que te tengan en Contacts.27
  • App Intents es la superficie para desarrolladores. Una app que incluye App Intents obtiene acciones de Shortcuts en el Mac sin trabajo adicional, y esas mismas intents impulsan Spotlight y las automatizaciones, incluidas las apps de iOS instaladas en Macs con Apple silicon.413
  • El consentimiento es el punto de fallo. Shortcuts muestra Allow Once / Always Allow / Don’t Allow por shortcut y por tipo de datos. Las acciones que ejecutan scripts están detrás de un interruptor global, “Allow Running Scripts”. Una ejecución sin interfaz que llega a una solicitud sin responder simplemente espera.168

Cómo usar esta guía

Tú eres… Comienza aquí Luego explora
Nuevo en Shortcuts en Mac ¿Qué es Shortcuts en Mac?, Formas de ejecutar un shortcut El catálogo de acciones, Triggers de automatización en macOS
Veterano de Automator o AppleScript Shortcuts vs Automator vs AppleScript, Acciones de scripting El CLI de shortcuts, Controlar la app con Shortcuts Events
Desarrollador que expone funciones de una app App Intents: cómo las apps agregan acciones Spotlight y las automatizaciones ejecutan tus intents, Controlar Shortcuts desde scripts y agentes
Integras shortcuts en agentes o CI El CLI de shortcuts, Controlar Shortcuts desde scripts y agentes Permisos y consentimiento, Solución de problemas

Tabla de contenidos

Parte 1: Fundamentos

  1. ¿Qué es Shortcuts en Mac?
  2. Formas de ejecutar un shortcut
  3. Shortcuts vs Automator vs AppleScript

Parte 2: Acciones

  1. Cómo se componen las acciones
  2. El catálogo de acciones
  3. Acciones de scripting
  4. Acciones de gestión de ventanas
  5. La acción Use Model

Parte 3: Automatizaciones

  1. Triggers de automatización en macOS
  2. Patrones de automatización que funcionan

Parte 4: La línea de comandos y los URL schemes

  1. El CLI de shortcuts
  2. Controlar la app con Shortcuts Events
  3. URL schemes

Parte 5: Compartir y distribuir

  1. Formatos para compartir y firma

Parte 6: La superficie para desarrolladores

  1. App Intents: cómo las apps agregan acciones
  2. Spotlight y las automatizaciones ejecutan tus intents
  3. Controlar Shortcuts desde scripts y agentes

Parte 7: Operaciones y referencia

  1. Permisos y consentimiento (TCC)
  2. Solución de problemas
  3. Tarjeta de referencia rápida
  4. Preguntas frecuentes
  5. Registro de cambios
  6. Referencias

¿Qué es Shortcuts en Mac?

Shortcuts es la app de automatización de Apple: encadenas acciones (pasos con un único propósito) en un shortcut (un flujo de trabajo guardado) y luego lo ejecutas con un clic, la voz, una pulsación de teclas, un trigger o la línea de comandos. Conviene tener presente la propia definición de Apple porque explica todo el diseño: “Una acción es el bloque de construcción de un shortcut. Cada shortcut consta de una serie de acciones, y cada acción es un único paso que realiza una función concreta”.12

La app llegó al Mac con macOS Monterey en 2021, portada desde iOS pero escrita casi por completo en SwiftUI para que la misma base de código funcione en ambas plataformas.5 Tres decisiones de diseño de aquella primera versión siguen definiendo la experiencia en Mac en 2026:

  • La sincronización con iCloud es la opción predeterminada. Abre Shortcuts en un Mac nuevo y aparecerá tu biblioteca existente, sincronizada desde iPhone y iPad. Un shortcut creado en un dispositivo se ejecuta en los demás, salvo las acciones específicas de una plataforma.512
  • Las apps proporcionan acciones. “Al igual que en iOS, cualquier app del Mac puede proporcionar acciones a Shortcuts”.5 En 2026, esa canalización es el framework App Intents, explicado en la Parte 6.
  • Los scripts son de primera clase. Monterey incorporó “compatibilidad completa con AppleScripts y Shell Scripting”, con “nuevas acciones integradas directamente en Shortcuts que te permiten escribir y ejecutar scripts dentro del editor de Shortcuts”; así, Shortcuts envuelve la pila de automatización anterior en lugar de reemplazarla.5

Lo que Monterey no incorporó fueron triggers. De 2021 a 2024, un shortcut en Mac solo se ejecutaba cuando algo lo invocaba. macOS Tahoe (26) cambió eso en 2025 al incorporar automatizaciones personales al Mac, con tipos de trigger diseñados específicamente para flujos de trabajo de escritorio (cambió el contenido de una carpeta, se conectó una unidad externa), además del conjunto ya establecido de iOS.34 Tahoe también agregó la acción Use Model, que procesa datos mediante modelos de Apple Intelligence a mitad de un shortcut.34

Hitos de versiones:

macOS Año Lo que agregó a Shortcuts
Monterey (12) 2021 App Shortcuts, CLI shortcuts, importación de Automator, acciones de scripts e integración con la barra de menús y Quick Action52
Ventura a Sequoia (13–15) 2022–2024 App Intents reemplaza la infraestructura anterior de intents como superficie para desarrolladores; App Shortcuts aparece sin configuración13
Tahoe (26) 2025 Automatizaciones personales en Mac, acción Use Model (Apple Intelligence), intents de apps ejecutables desde Spotlight34

A lo largo de la guía, “verificado en macOS 26.5” significa que se comprobó directamente con Shortcuts 7.0 en el Mac utilizado para redactarla.


Formas de ejecutar un shortcut

Shortcuts en el Mac es inusualmente generoso con los puntos de entrada. Todos los siguientes invocan el mismo shortcut; se diferencian por el origen de la entrada y el destino de la salida.1210

Punto de entrada Cómo Ideal para
App Shortcuts Haz doble clic en el shortcut o clic en ▶ Crear y probar
Barra de menús Agrega el shortcut a la categoría de barra de menús y ejecútalo desde el ícono de Shortcuts en la barra de menús Utilidades de uso frecuente
Quick Actions (Finder) Activa “Use as Quick Action” en los detalles del shortcut; luego haz Control-clic en un archivo → Quick Actions Shortcuts de procesamiento de archivos que toman como entrada las selecciones de Finder10
Menú Services Activa “Services Menu” en los detalles; aparece en el menú App → Services Shortcuts basados en texto o selecciones en cualquier app10
Atajo de teclado Panel de detalles → Add Keyboard Shortcut; presiona una combinación Cualquier cosa que ejecutes muchas veces al día10
Spotlight Escribe el nombre del shortcut y ejecútalo en línea; un shortcut ejecutado de esta forma puede aceptar entrada, como texto seleccionado de un documento abierto Invocación centrada en el teclado sin dedicar un atajo de teclado34
Control Center Agrega un shortcut como control — Run Shortcut, Open App o Show la colección “Menu Bar” Acceso con un clic desde Control Center o la barra de menús3
Siri Di el nombre del shortcut Manos libres
Dock Arrastra un shortcut desde la app hasta el Dock Iniciadores con un clic
Automatizaciones Basadas en triggers, macOS Tahoe y versiones posteriores Ejecuciones sin supervisión (Parte 3)
Línea de comandos shortcuts run "Name" Scripts, Makefiles, CI, agentes (Parte 4)
URL scheme shortcuts://run-shortcut?name=... Invocación desde otras apps9
Shortcuts Events AppleScript/ScriptingBridge, sin interfaz Ejecuciones en segundo plano con resultados devueltos a quien hace la llamada11

Dos detalles ahorran tiempo más adelante. Primero, las entradas de Quick Action y Services reciben la selección actual como entrada del shortcut; por eso, los shortcuts de procesamiento de archivos deben declarar los tipos de entrada que aceptan (la configuración “Receive” del editor) en lugar de asumir que recibirán texto. Segundo, las tres últimas filas constituyen la superficie programable; tienen secciones propias porque sus contratos de entrada y salida son diferentes.

Shortcuts vs Automator vs AppleScript

Los 3 sistemas de automatización de Apple siguen incluidos en macOS en 2026 (Automator permanece en /System/Applications, verificado en macOS 26.5), y cada uno conserva su función. El enfoque que se mantiene vigente es el siguiente: Shortcuts funciona como capa de integración, AppleScript como lenguaje de control de aplicaciones y los scripts de shell como capa de procesamiento. Automator está en modo de mantenimiento: sigue funcionando, no ha cambiado y Shortcuts es oficialmente su sucesor.514

Shortcuts Automator AppleScript / JXA Scripts de shell
Modelo Acciones + activadores, sincronización mediante iCloud Acciones en documentos .workflow Lenguaje que envía Apple Events a las aplicaciones Procesos Unix
Integración con aplicaciones App Intents (moderna y en expansión) Plugins de acciones heredados (sin desarrollo) Diccionarios de scripting (profundos, pero dependen de cada aplicación) Solo CLIs
Activadores Automatizaciones personales (Tahoe+)3 Folder Actions, alarmas de Calendar Ninguno integrado cron, launchd
También se ejecuta en iPhone/iPad 12 No No No
Estado en 2026 En desarrollo activo Con mantenimiento, sin nuevas inversiones Con mantenimiento Siempre vigente

La ruta de migración existe, pero presenta pérdidas en algunos casos extremos. Apple incorporó un convertidor en Shortcuts: arrastra un archivo .workflow hasta la aplicación (o haz Control-clic → Open With → Shortcuts) y «Shortcuts puede convertir la mayoría de los flujos de trabajo de Automator en shortcuts que realizan las mismas funciones, eventos y automatizaciones».1415 «La mayoría» es la expresión que utiliza Apple y, en la práctica, significa que las acciones estándar para archivos, imágenes y texto se convierten correctamente, mientras que la conversión pierde fidelidad con acciones poco comunes de terceros para Automator y grabaciones de Watch Me Do. Shortcuts incluso conserva internamente el nombre de una acción Watch Me Do como parte de esa compatibilidad (visible en la tabla de acciones del framework, verificado en macOS 26.5).16

Cuándo conviene ir más allá de Shortcuts. El control profundo de cada aplicación —como recorrer mensajes de Mail, manipular ventanas de Finder mediante programación o controlar aplicaciones con diccionarios de scripting completos— sigue siendo el terreno de AppleScript. El procesamiento complejo de texto, la orquestación de API y cualquier cosa que de todos modos escribirías en Python o zsh corresponden a un script. En la práctica, la clave está en combinar, no en elegir un único sistema: un shortcut que recibe datos de un activador, los entrega a un script de shell para realizar el trabajo pesado y utiliza acciones nativas para las notificaciones y la ubicación de archivos aprovecha lo mejor de cada sistema. La sección Acciones de scripting explica el funcionamiento.


Cómo se componen las acciones

Cada shortcut es una canalización. Cada acción recibe una entrada —a menudo, la salida de la acción anterior—, realiza una tarea y genera una salida. Hay 3 mecanismos que aportan expresividad a la canalización:

  • Variables mágicas. La salida de cada acción queda disponible automáticamente como variable para las acciones posteriores, sin necesidad de declarar nada. Haz clic en un campo de parámetro, elige Select Magic Variable y selecciona la salida de cualquier acción anterior. Set Variable y Get Variable permiten asignar nombres explícitos, mientras que Add to Variable acumula listas (las 3 son acciones integradas, verificadas en macOS 26.5).16
  • Tipos de contenido, convertidos según sea necesario. Las acciones declaran qué tipos de datos aceptan —archivos, imágenes, texto, URL o fechas—. Cuando los tipos de salida y entrada no coinciden, Shortcuts realiza una conversión siempre que sea posible: si pasas una página web a una acción de texto, obtienes el texto de la página. La configuración «Receive» situada en la parte superior del editor declara qué acepta el shortcut completo desde Quick Actions, Services o la opción --input-path de CLI.
  • Control de flujo mediante acciones. If, Repeat, Repeat with Each, Choose from Menu, Wait to Return, Stop This Shortcut y Stop and Output son acciones comunes.16 Stop and Output tiene más importancia en la Mac que en cualquier otro lugar, ya que define lo que un shortcut devuelve a la línea de comandos, una canalización o un script que lo invoca.1

El mecanismo básico de composición es Run Shortcut: un shortcut invoca a otro por su nombre y le proporciona una entrada.16 Apple indica explícitamente que, para anidar shortcuts, debe utilizarse la acción y no los URL schemes: «Si quieres ejecutar un shortcut desde otro shortcut, utiliza la acción Run Shortcut en lugar de un URL scheme».9 Trata los shortcuts como funciones: los shortcuts pequeños y especializados —normalizar el nombre de un archivo, enviar datos a un webhook o reducir una imagen al tamaño de una miniatura—, combinados mediante un shortcut coordinador, escalan mucho mejor que un monolito de 60 acciones. Además, cada pieza puede probarse de manera independiente desde CLI.


El catálogo de acciones

La biblioteca integrada es extensa: la tabla de cadenas en inglés del framework WorkflowKit de macOS 26.5 —el framework privado en el que se basa Shortcuts— enumera 361 nombres de acciones distintos.16 Esta cifra supera la cantidad que verás en el editor, pues la tabla incluye acciones exclusivas de iOS e integraciones heredadas de la época en que la aplicación se llamaba Workflow. A continuación se presenta el catálogo relevante para la Mac, organizado según las tareas que quienes crean automatizaciones necesitan realizar en la práctica. Todos los nombres de acciones que aparecen a continuación figuran textualmente en esa tabla, según se verificó en macOS 26.5.16

Archivos y Finder

Acción Qué hace
Get File from Folder / Get Contents of Folder Lee archivos o listas de contenido de carpetas
Save File / Move File / Rename File / Delete Files / Label Files Gestiona el ciclo de vida de los archivos
Create Folder / Get Parent Directory / Get Link to File Gestiona la estructura de carpetas
Filter Files / Get Details of Files Consulta por nombre, extensión, fecha o tamaño
Get Selected Files in Finder / Reveal Files in Finder Se conecta con la selección de Finder
Make Archive / Extract Archive Comprime y descomprime archivos
Make Disk Image / Mount Disk Image / Eject Disk Gestiona imágenes de disco y volúmenes
Append to Text File Realiza escrituras similares a las de un registro

Sistema y aplicaciones

Acción Qué hace
Open App / Quit App / Hide App Gestiona el ciclo de vida de las aplicaciones
Split Screen Apps Organiza 2 aplicaciones una al lado de la otra
Set Focus / Get Current Focus Gestiona los modos de concentración
Set Volume / Play Sound / Start Screen Saver Gestiona los controles del entorno
Show Notification / Speak Text Proporciona canales de respuesta
Get Device Details / Get Network Details / Get Current IP Address Obtiene información del entorno
Get Details of Appearance Consulta la apariencia clara u oscura
Print / Quick Look Envía el resultado a papel o a una vista previa

Web y datos

Acción Qué hace
Get Contents of URL El cliente HTTP: utiliza GET de manera predeterminada y permite configurar el método, los encabezados y el cuerpo para las llamadas a API
Get Contents of Web Page / Get Article using Safari Reader Extrae contenido de páginas
Get Current Web Page from Safari Integración con Safari (consulta también Run JavaScript on Web Page, en Acciones de scripting)
Get Headers of URL / Get Component of URL / URL Encode Gestiona la infraestructura de HTTP y URL
Get Items from RSS Feed / Get RSS Feeds from Page Gestiona fuentes RSS
Get Dictionary from Input / Get Text from Input / Set Dictionary Value JSON de entrada, JSON de salida
Generate Hash / Base64 Encode Proporciona utilidades de codificación

Get Contents of URL, junto con las acciones Dictionary, conforma un cliente REST funcional: realiza una solicitud, analiza JSON y extrae valores, sin necesidad de escribir código. Cuando las cargas útiles se vuelvan complejas, transfiere el trabajo a un script de shell con curl y jq en lugar de luchar contra diccionarios anidados en el editor.

Texto, imágenes y contenido multimedia

Acción Qué hace
Text / Replace Text / Search Text / Transform Text / Trim Whitespace Manipula texto
Make Rich Text from Markdown / Make Markdown from Rich Text / Make HTML from Rich Text Convierte formatos
Get Text from PDF / Extract Text from Image / Make PDF / Split PDF Into Pages / Optimize File Size of PDF Procesa documentos (Extract Text from Image realiza OCR en el dispositivo)
Resize Image / Crop Image / Convert Image / Flip Image / Mask Image / Overlay Image / Remove Image Background / Combine Images Procesa imágenes mediante una canalización
Make GIF / Add Frame to GIF / Make Video from GIF / Encode Media / Trim Media Convierte contenido multimedia
Make Spoken Audio from Text / Record Audio / Dictate Text Gestiona la entrada y salida de audio

Calendar, Reminders, Contacts y 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 y sus equivalentes Get Details of… abarcan las aplicaciones de productividad.16 La combinación Find/Filter + Get Details es el patrón habitual: consulta una colección y luego extrae campos de los resultados coincidentes.

Shortcuts, metaprogramación y flujo

Acción Qué hace
Run Shortcut Invoca otro shortcut con datos de entrada
Get My Shortcuts / Get Details of Shortcut Inspecciona la biblioteca
If / Repeat / Repeat with Each / Choose from Menu Controla el flujo
Set Variable / Get Variable / Add to Variable Gestiona el estado explícito
Wait to Return / Stop This Shortcut / Stop and Output / Nothing Gestiona los tiempos y la finalización
Show Content / Get What’s On Screen Gestiona la visualización y el contexto
Open X-Callback URL / Open URLs Envía solicitudes mediante URL

Una observación sobre la metaautomatización para la Parte 6: Get My Shortcuts y Get Details of Shortcut permiten que un shortcut enumere la biblioteca, lo que se complementa con shortcuts list del lado de CLI para crear herramientas en torno a tu colección.162


Acciones de scripting

Cinco acciones conectan Shortcuts con la pila de automatización tradicional, y las cinco dependen de un único interruptor global. En Shortcuts → Settings → Advanced, “Allow Running Scripts” debe estar activado antes de que cualquiera de ellas se ejecute; la descripción de la propia app especifica exactamente qué acciones habilita: “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” (verificado en macOS 26.5).817 La documentación de Apple añade la advertencia de que ejecutar shortcuts con scripts podría causar pérdida de datos: esta configuración existe porque estas cinco acciones se ejecutan con todos tus privilegios de usuario, fuera de las salvaguardas que limitan las acciones normales.8

Run Shell Script

El caballo de batalla. Eliges el shell, pegas el script y decides cómo llega la entrada. Los dos modos de entrada proceden directamente de la documentación de la acción: “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.”17

Implicaciones prácticas de esos dos modos:

  • El modo stdin es adecuado para texto y archivos individuales: procesamiento al estilo pbpaste, JSON mediante jq, cualquier cosa que lea un flujo.
  • El modo arguments es adecuado para varios archivos: cada elemento de entrada llega a "$@", así que for f in "$@"; do ... done gestiona correctamente una selección de Finder, incluidos los espacios.
  • La salida es todo lo que el script escribe en stdout, y pasa a la siguiente acción como cualquier otra salida.

Run AppleScript y Run JavaScript for Mac Automation

Ambas incorporan scripts de Open Scripting Architecture con un punto de entrada on run {input, parameters} (AppleScript) o una función run(input, parameters) (JXA). Úsalas cuando la tarea consista en controlar otra app: organización de ventanas de Finder, reglas de Mail o cualquier cosa con un diccionario de scripting. El valor de retorno se convierte en la salida de la acción.

Run Script Over SSH

Ejecuta un script de shell en un host remoto con el host, el puerto, el usuario y la autenticación configurados en la acción. El caso de uso decisivo es simétrico con la CLI: una Mac en tu oficina puede exponer operaciones repetibles a cualquier máquina que pueda alcanzarla mediante SSH, y un shortcut puede enviar trabajo a equipos Linux sin salir del editor de Shortcuts.

Run JavaScript on Web Page

Ejecuta JavaScript en la página actual de Safari y devuelve el resultado. Apple lo condiciona tanto al interruptor de scripts como a una solicitud de permiso en cada ejecución, porque JavaScript arbitrario en el contexto de una página puede facilitar la exfiltración de datos.8


Acciones de gestión de ventanas

Shortcuts incluye control nativo de ventanas en la Mac: Find Windows, Move Window y Resize Window.16 Parecen entradas menores del catálogo, pero resultan ser los componentes básicos para crear distribuciones de ventanas controladas por teclado sin herramientas de terceros.

  • Find Windows consulta las ventanas abiertas (ordenables y filtrables en el editor) y genera objetos de ventana.
  • Move Window recibe una ventana y una posición. El resumen de sus parámetros dice “Move ⟨Window⟩ to ⟨Position⟩”, con una variante personalizada opcional: “Move ⟨Window⟩ to ⟨Position⟩ ⟨X Coordinate⟩, ⟨Y Coordinate⟩” (verificado en macOS 26.5).16
  • Resize Window recibe una ventana y un destino: “Resize ⟨Window⟩ to ⟨Configuration⟩”, con una variante personalizada que acepta ⟨Width⟩ × ⟨Height⟩ explícitos.16

Las posiciones de ventana integradas en la tabla de cadenas del framework son: Full Screen, Left, Right, Top, Bottom, tercios (Left Third, Middle Third, Right Third), variantes de esquina (Top/Bottom Leading y Trailing), y un formato personalizado de Window Location and Size (verificado en macOS 26.5).16 Combina Find Windows (ventana frontal) → Resize Window (Left) con un atajo de teclado y tendrás un comando de ventana de una sola tecla. Split Screen Apps resuelve el caso de dos apps en una acción.16


La acción Use Model

Nueva en macOS Tahoe y la acción individual más importante que Apple ha añadido desde la llegada de Shortcuts a la Mac: Use Model envía datos a un modelo de Apple Intelligence a mitad de un shortcut y entrega la respuesta a la siguiente acción.34

Tres opciones de modelo, según la sesión de WWDC de Apple sobre la función: un modelo grande basado en servidor en Private Cloud Compute, el modelo en el dispositivo “for simple requests without network connection” y ChatGPT “for broad world knowledge.”4

Tres formatos de salida, y elegir de forma deliberada es la clave:4

  1. Text (incluido texto enriquecido) para resúmenes y reescrituras.
  2. Dictionary para extracción estructurada; el ejemplo de Apple extrae proveedor, importe y fecha de facturas. La salida Dictionary es lo que hace que Use Model sea componible: las acciones posteriores leen campos en lugar de analizar prosa.
  3. App entities: objetos de contenido de apps que los exponen mediante App Intents. Apple describe la relación así: “If App Intents are the actions or verbs from your app, App Entities are the nouns,”4 y Use Model puede razonar directamente sobre esos sustantivos (filtrar estas notas, elegir el evento de calendario pertinente).

Un interruptor de Follow Up permite iterar sobre la respuesta del modelo dentro de la misma ejecución.4

Una advertencia de ingeniería: la salida del modelo no es determinista, por lo que la misma entrada puede producir resultados distintos en cada ejecución. Para las automatizaciones, esto favorece el formato de salida Dictionary (restringido por esquema), prompts pequeños y enfocados, y un paso de validación (una acción If que compruebe los campos obligatorios) antes de que el resultado afecte archivos o mensajes. Trata Use Model como una llamada de red poco fiable: útil, pero envuelta en comprobaciones.

Para la perspectiva de desarrollador sobre la misma función (lo que tu app debe exponer para que Use Model pueda razonar sobre ello), consulta la Parte 6 y el grupo de App Intents en este sitio, comenzando con App Intents Are Apple’s New API to Your App.


Triggers de automatización en macOS

Las automatizaciones son shortcuts con un trigger asociado: “ejecuta esto cuando ocurra aquello”, sin necesidad de hacer clic. Llegaron a la Mac en macOS Tahoe, y Apple creó triggers específicos para Mac en lugar de trasladar sin cambios la lista de 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.”4

Créelas desde el área Automation de la app Shortcuts. Cada automatización combina un trigger con un conjunto de acciones y una decisión de política: Run Immediately (sin interacción, el objetivo de la automatización) o Run After Confirmation (una notificación pregunta primero).318 Inicia las automatizaciones nuevas con confirmación hasta que confíes en ellas; después, cambia a ejecución inmediata.

El catálogo de triggers en macOS Tahoe:3418

Trigger Se activa cuando Notas
Time of Day Llega una hora (específica, amanecer o atardecer) Opciones de repetición diaria, semanal o mensual
Alarm Una alarma de la app Clock suena, se pospone o se detiene
Email Llega correo de remitentes elegidos o que coincide con criterios
Message Llega un mensaje de personas elegidas o que contiene texto
Folder Cambia el contenido de una carpeta supervisada El elemento destacado de la Mac; consulta los patrones más abajo
File Se modifica un archivo supervisado Distinto de Folder: el ejemplo de Apple es “When my file is modified”3
External Drive Se conecta o desconecta una unidad Flujos de trabajo de respaldo e ingesta
Display Se conecta o desconecta una pantalla Distribuciones al conectar el equipo al escritorio
Wi-Fi Te conectas o sales de una red Contexto similar a ubicación en un sistema operativo de escritorio
Bluetooth Se conecta o desconecta un dispositivo Audífonos, dispositivos de entrada
Battery Level El nivel alcanza, sube por encima o baja por debajo de un umbral Relevante para laptops
Charger Se conecta o desconecta la alimentación Relevante para laptops
App Una app se abre o se cierra Combínalo con Split Screen Apps o acciones de ventana
Focus Se activa o desactiva un modo Focus
Stage Manager Se activa o desactiva Stage Manager

Del diseño se desprenden dos cambios. Primero, la Mac por fin tiene una respuesta nativa de Apple a «supervisa esta carpeta y procesa lo que llegue a ella», que se sincroniza y edita como cualquier otro shortcut (las Folder Actions de Automator realizaban la supervisión, pero no el resto). Segundo, como las automatizaciones ejecutan shortcuts, todo lo que aparece en esta guía se combina: un trigger Folder puede alimentar Run Shell Script; un trigger App puede llamar a Use Model; un trigger External Drive puede iniciar un trabajo de SSH.


Patrones de automatización que funcionan

Patrones que resisten el uso diario, creados íntegramente a partir de componentes documentados:

La carpeta activa. Activador de carpeta en ~/Inbox → Filtrar archivos (la extensión es pdf) → Extraer texto de una imagen u Obtener texto de un PDF → Use Model con salida de diccionario (proveedor, fecha, total) → Renombrar archivo y Mover archivo a una jerarquía de archivo. El caso de uso clásico de Automator, mejorado con extracción en el dispositivo y nombres estructurados mediante un modelo.3416

El escritorio acoplado. Activador de pantalla (se conecta una pantalla externa) → Abrir app para tu conjunto de trabajo → Mover ventana y Redimensionar ventana según tu distribución → Establecer el modo de concentración Trabajo. Invierte el proceso al desconectarla. Un solo activador reconstruye toda la distribución del escritorio sin tener que arrastrar nada manualmente.316

La unidad de importación. Activador de unidad externa → Obtener contenido de la carpeta DCIM de la tarjeta → Filtrar archivos por fecha → Guardar archivo en una carpeta con fecha → Mostrar notificación con la cantidad. Aquí conviene usar el modo de confirmación: las unidades que no esperabas no deberían activar copias masivas.318

La vía de escape hacia código real. Cualquier activador → Ejecutar script de shell con la entrada como argumentos → tu script existente. El sistema de activadores es la parte valiosa; nada exige que la lógica resida en las acciones de Shortcuts. Una automatización de dos acciones (activador + script) ofrece gestión de eventos al estilo de launchd, además de interfaz, sincronización y administración del consentimiento sin costo adicional.817

Contextos relacionados con reuniones. Activador de modo de concentración (se activa el modo Trabajo)18 → Ajustar volumen, Salir de app para eliminar distracciones, Abrir app para tomar notas. Si habilitas en Configuración del Sistema la sincronización de los modos de concentración entre dispositivos, la Mac reacciona cuando se activa uno desde el iPhone.

Restricciones que debes tener en cuenta al diseñar: una automatización reside en la Mac donde la creas, por lo que una automatización de carpeta configurada en la MacBook no se ejecutará en la Mac mini, aunque la biblioteca de atajos sí se sincronice (configura el activador en cada equipo que lo necesite); además, la lista de activadores no incluye la opción «solicitud web recibida» (puedes resolverlo con Ejecutar script mediante SSH desde el equipo emisor o con una carpeta supervisada por un cliente de sincronización en la nube).318


La CLI de shortcuts

Desde Monterey, macOS incluye una verdadera interfaz de línea de comandos para Shortcuts: /usr/bin/shortcuts, documentada en shortcuts(1) y en la guía del usuario de Apple.12 Tiene cuatro subcomandos. Verifiqué todo lo que aparece a continuación en 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

Ejecuta un atajo por nombre o identificador. «Ejecutar atajos desde la línea de comandos no es diferente de ejecutarlos en la app Shortcuts»,1 lo cual implica tanto ventajas como inconvenientes: acceso completo a las acciones y todas las solicitudes de permisos (consulta Permisos).

Opción Significado
-i, --input-path Entrada para el atajo. Puede repetirse; acepta rutas, patrones glob o - para stdin2
-o, --output-path Destino donde se escribirá la salida; - para stdout2
--output-type Formato de salida expresado como Uniform Type Identifier, por ejemplo public.plain-text o com.apple.rtfd; si se omite, se infiere del nombre del archivo de salida2

El ejemplo canónico de Apple ejecuta un atajo que combina imágenes sobre una carpeta de archivos JPEG:1

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

La CLI respeta el contrato de Unix tanto para la entrada como para la salida. Estado de salida: «El comando shortcuts finaliza con 0 si la ejecución tiene éxito o con 1 si se produce un error».1 La canalización de la salida funciona cuando el atajo termina con una salida o contiene Detener y generar salida:1

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

Hay una trampa documentada: al canalizar texto hacia shortcuts run, este se entrega como texto. «Cuando pasas una ruta de archivo mediante una canalización, la ruta se interpreta como texto. Usa la opción -i para garantizar que la entrada se trate como rutas de archivo».1

Y una regla de diseño de Apple que vale la pena recordar: «los atajos más eficientes son aquellos que no muestran alertas ni solicitan entradas. Cuando un atajo solicita una entrada, el proceso de la línea de comandos se detiene a la espera de que el usuario responda».1 En cualquier ejecución sin interfaz, esa pausa equivale a un bloqueo. Diseña los atajos orientados a la CLI para que reciban todos sus parámetros mediante la entrada.

shortcuts list

Enumera los nombres de los atajos, uno por línea. --folders enumera las carpetas; -f <folder> limita el resultado a una carpeta («none» para los atajos que no pertenecen a ninguna); --show-identifiers agrega el UUID de cada atajo.2 Los identificadores son importantes para la automatización: los nombres pueden coincidir y cambiar, pero los UUID no. shortcuts run acepta cualquiera de los dos.2

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

shortcuts view

Abre el atajo indicado en el editor de Shortcuts.2 Resulta útil al final de una herramienta: un script que detecte un atajo con errores puede llevarte directamente a su editor.

shortcuts sign

Firma un archivo .shortcut para su distribución; se explica junto con los formatos para compartir en la Parte 5.2


Automatización de la app con Shortcuts Events

La tercera interfaz programática es la de scripting. Shortcuts registra dos destinos que admiten scripts en la Mac: la propia app Shortcuts y un asistente en segundo plano sin interfaz, Shortcuts Events (identificador de paquete com.apple.shortcuts.events, verificado en macOS 26.5).11 El diccionario de scripting explica el motivo de esta separación: «Para ejecutar un atajo en segundo plano sin abrir la app Shortcuts, usa “Shortcuts Events” en lugar de “Shortcuts”».11

El diccionario es pequeño y estable. Los atajos tienen las propiedades de solo lectura name, subtitle, id, folder, color, icon, accepts input y action count; las carpetas tienen name e id; y el único verbo es run, con un parámetro opcional with input y un resultado.11

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 mediante ScriptingBridge o py-applescript utiliza la misma interfaz; con ScriptingBridge de PyObjC, SBApplication.applicationWithBundleIdentifier_("com.apple.shortcuts.events") devuelve el objeto de la app, cuya colección shortcuts() refleja el diccionario anterior.11

Cuándo conviene usarla en lugar de la CLI: cuando ya estás en un contexto de AppleScript/JXA, quieres obtener el resultado del atajo como un objeto nativo en vez de stdout serializado o ejecutas atajos desde una app que puede enviar Apple Events, pero no debería invocar un shell. El primer Apple Event que un proceso anfitrión envía a Shortcuts Events muestra la solicitud estándar de consentimiento de Automatización de macOS (Configuración del Sistema → Privacidad y seguridad → Automatización), un permiso más que debes conceder antes de ejecutar el proceso sin supervisión.6

El diccionario también ofrece acceso para organizar la biblioteca: permite leer las carpetas y los metadatos de los atajos, así como modificar la carpeta asignada. Por lo tanto, puedes automatizar las tareas de mantenimiento —como informes de inventario y auditorías de carpetas— sin interactuar con la interfaz.11


URL schemes

Shortcuts registra el URL scheme shortcuts:// (además del antiguo workflow://, heredado de los orígenes de la app antes de su adquisición y verificado en macOS 26.5).19 Las URL son la vía de integración para otras apps: lanzadores, apps de notas con campos para enlaces y cualquier herramienta capaz de abrir una URL. La recomendación de Apple es directa: «Solo deberías ejecutar atajos mediante una URL si realizas la integración desde otra app externa a Shortcuts».9

Ejecutar un atajo:9

shortcuts://run-shortcut?name=[name]&input=[input]&text=[text]
  • name (obligatorio): nombre del atajo codificado con caracteres de escape porcentuales.
  • input: puede ser text o clipboard. Con text, el valor del parámetro text se convierte en la entrada del atajo; con clipboard, «se usa el contenido del portapapeles» y se ignora text.9
shortcuts://run-shortcut?name=Lookup%20Goetta&input=text&text=goetta%20is%20great
shortcuts://run-shortcut?name=Add%20to%20Notes&input=clipboard

x-callback-url agrega gestión de respuestas para los intercambios de ida y vuelta:20

shortcuts://x-callback-url/run-shortcut?name=Calculate%20Tip&input=text&text=24.99&x-success=...&x-error=...&x-cancel=...
  • x-success se abre si la operación tiene éxito y agrega la salida de texto del atajo como parámetro result.
  • x-error se abre si la operación falla e incluye un parámetro errorMessage.
  • x-cancel se abre si el usuario cancela y no proporciona ninguna salida.20

Desde el shell, open "shortcuts://run-shortcut?..." funciona, pero allí es preferible usar shortcuts run: la CLI devuelve directamente códigos de salida y resultados, en lugar de depender de callbacks mediante URL. En la Mac, el nicho restante de este esquema es la integración entre apps y los enlaces incluidos en documentos.


Formatos para compartir y firma

Los Shortcuts se distribuyen de 2 maneras, y ambas terminan en una decisión de confianza.7

Enlaces de iCloud. En la app: compartir → Copy iCloud Link (Copiar enlace de iCloud). Cualquier persona que tenga el enlace puede agregar el shortcut a su biblioteca, lo que convierte estos enlaces en la opción más sencilla para publicarlo abiertamente. Considera que un enlace es público desde el momento en que lo envías.7

Archivos de shortcut. File → Export (Archivo → Exportar) genera un archivo .shortcut (UTI com.apple.shortcut, verificado en macOS 26.5).197 Al exportarlo, debes elegir una opción de confianza:

  • Anyone (Cualquiera): «Cualquiera puede ejecutar tu shortcut». Apple recibe una copia del shortcut para validarlo.7
  • People Who Know Me (Personas que me conocen): «Solo podrán ejecutar tu shortcut quienes te tengan entre sus contactos». Tu información de contacto se incorpora al archivo para realizar esa comprobación.7

La CLI reproduce estos mismos 2 modos y da nombre al mecanismo, según shortcuts(1) en macOS 26.5: people-who-know-me «firmará localmente, pero solo tus dispositivos o las personas que tengan tu información entre sus contactos podrán importar el shortcut», mientras que anyone «lo certificará mediante iCloud y permitirá que cualquiera importe el shortcut».2

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

Ese comando resuelve la distribución para equipos y CI: los shortcuts exportados y firmados con -m anyone se importan sin problemas para destinatarios que no te conocen. Como el modo anyone certifica el archivo mediante iCloud, asegúrate de tener una sesión iniciada en iCloud y acceso a la red antes de incorporarlo a un proceso de compilación.2

La importación se realiza arrastrando y soltando: haz doble clic en un archivo .shortcut, arrástralo a la app o suéltalo sobre el icono del Dock; los archivos .workflow se convierten desde Automator durante la importación.15 Los Shortcuts compartidos fuera de Gallery incluyen una advertencia que Apple expresa con claridad: «Apple no puede verificar la autenticidad ni el comportamiento de los shortcuts compartidos de forma privada».6 Las flotas corporativas disponen de una vía aparte: Apple Configurator admite automatizaciones de Shortcuts para flujos de trabajo administrados.21

Settings → Advanced (Configuración → Avanzado) también contiene Private Sharing (Uso compartido privado), la opción que controla la importación de shortcuts compartidos de forma privada y restringidos a contactos, junto con Allow Running Scripts (Permitir la ejecución de scripts) y Allow Sharing Large Amounts of Data (Permitir compartir grandes cantidades de datos).68 Si un shortcut recibido no se puede importar, la causa suele ser una de estas: el archivo no está firmado, está restringido a los contactos y proviene de alguien que no figura entre los tuyos, o Private Sharing está desactivado.


App Intents: cómo agregan acciones las apps

Todo lo incluido hasta ahora en el catálogo proviene de Apple. La otra mitad de la biblioteca procede de las apps instaladas y, desde 2022, todo pasa por un único framework: App Intents (iOS 16, macOS 13).13 Una app define tipos que cumplen con AppIntent (un verbo: parámetros más un método perform()), de forma opcional con AppEntity (un sustantivo: una parte tipada del contenido de la app con un identificador y una representación visual), y el sistema se encarga del resto. Las mismas definiciones aparecen en Shortcuts, Siri, Spotlight, widgets y Apple Intelligence; Shortcuts es una proyección del esquema de intents de la app, no una integración independiente.134

Hay 2 niveles de adopción que determinan cómo aparece una app en la Mac:

  • Acciones: cada intent que no esté oculto aparece como una acción en el editor de Shortcuts bajo el nombre de la app y puede combinarse con todo lo descrito en esta guía.
  • App Shortcuts: los intents encapsulados en un AppShortcutsProvider se incluyen como shortcuts listos para ejecutarse desde el momento en que se instala la app, sin que el usuario tenga que configurarlos y con frases de activación de Siri asociadas.13

El alcance del framework continúa ampliándose cada año. La sesión de WWDC25 sobre Shortcuts y Spotlight explica directamente el contrato actual para la Mac: «Siempre que tu intent esté disponible en macOS, también podrá utilizarse en Shortcuts como parte de las automatizaciones en la Mac. Esto incluye las apps de iOS que pueden instalarse en macOS».4 Una app para iPhone que se ejecuta en una Mac con Apple silicon aporta acciones a las automatizaciones de la Mac sin una sola línea de código específica para esta plataforma.

En resumen, las recomendaciones de Apple para la adopción que se presentaron en la misma sesión son: expón tu contenido como entidades con «propiedades clave sobre las que quisieras que un modelo pudiera razonar» (la acción Use Model las utiliza), incluye acciones de búsqueda para que las consultas funcionen, usa cadenas con atributos cuando el texto enriquecido resulte apropiado y procura que los resúmenes de parámetros sean legibles.4

Recomendaciones de diseño para autores de intents, extraídas de la implementación de App Intents en apps de producción:

  • Los intents son API. Trata los nombres, los parámetros y los identificadores de entidades como un contrato; cambiarles el nombre rompe los shortcuts de los usuarios del mismo modo que renombrar un endpoint rompe los clientes.
  • El segundo plano supera al primer plano. Un intent que puede ejecutarse sin abrir la app se integra en las automatizaciones; uno que exige pasar al primer plano interrumpe lo que estaba haciendo el usuario. Sepáralos deliberadamente.4
  • Los valores devueltos alimentan los procesos. Un intent que devuelve una entidad o un valor ofrece a los usuarios de Shortcuts algo que encadenar; uno que no devuelve nada es un callejón sin salida dentro del grafo.

Este sitio aborda en profundidad el lado del desarrollador en el conjunto de artículos sobre App Intents: App Intents son la nueva API de Apple para tu app (los argumentos para adoptarlos y un recorrido por una implementación de producción), App Intents 2.0 en iOS 26 (Visual Intelligence, snippets y propiedades diferidas), App Intents en iOS 27 (intents de larga duración en segundo plano, entidades sincronizables y reindexación de Spotlight) y App Intents frente a MCP (cuándo la misma capacidad también debería ofrecerse como herramienta para agentes).


Spotlight y las automatizaciones ejecutan tus intents

macOS Tahoe amplió los lugares donde se ejecutan los intents, y las 2 incorporaciones cambian lo que ganas en la Mac al adoptar App Intents.4

Spotlight ejecuta intents directamente. «Este año ya puedes ejecutar acciones de tu app directamente desde Spotlight en la Mac. Tus apps pueden mostrar acciones en Spotlight mediante la adopción de App Intents, igual que lo hacen en Shortcuts».4 Los requisitos son lo bastante específicos como para auditarlos:

  1. El resumen de parámetros («una representación breve y en lenguaje natural de lo que hace el intent de la app») «debe contener todos los parámetros obligatorios que no tengan un valor predeterminado».4
  2. El intent no debe excluirse de la detección: establecer isDiscoverable en false o assistantOnly en true lo elimina de Spotlight.4
  3. Las sugerencias y la búsqueda proceden de la capa de entidades: implementa entidades sugeridas o una consulta de entidades enumerables para el selector, además de una consulta de entidades mediante texto o entidades indexadas para buscar a medida que se escribe.4

Las automatizaciones ejecutan intents sin supervisión. Como las automatizaciones de Tahoe ejecutan shortcuts y estos, a su vez, ejecutan intents, un cambio en una carpeta o el montaje de una unidad ya pueden invocar el intent de una app sin que el usuario esté presente.4 Para los autores de intents, esto eleva el estándar establecido en la sección anterior: un intent que presupone la presencia de un usuario en primer plano —porque muestra una interfaz o requiere confirmación— falla silenciosamente dentro de una automatización Run Immediately. Audita cada intent para su ejecución sin supervisión: ¿qué sucede cuando nadie está mirando la pantalla?

En conjunto, ambas funciones expresan discretamente la postura arquitectónica de Apple: el intent, no la ventana de la app, es la unidad funcional en la Mac. Spotlight actúa como el invocador interactivo, las automatizaciones como el invocador sin supervisión y Shortcuts como la capa de composición entre ambos.


Control de Shortcuts desde scripts y agentes

Shortcuts ocupa un nicho específico en las arquitecturas de agentes y scripts: es la forma con menos privilegios y más auditable por el usuario para que el código externo invoque funciones de Mac. Un agente de IA con acceso al shell puede hacer la mayoría de las cosas directamente, pero canalizar una operación mediante un shortcut ofrece propiedades que el shell por sí solo no tiene: la operación está definida por el usuario y este puede editarla, sus permisos se conceden por shortcut y pueden revocarse con un clic, y su radio de impacto es visible en el editor.6 Piensa en la capa de shortcuts como un catálogo de capacidades que la persona administra y el agente invoca.

Hay un requisito indispensable para que todo esto funcione: la CLI necesita una sesión gráfica iniciada. Cada subcomando de shortcuts —incluido list— se comunica con una aplicación auxiliar en la sesión Aqua del usuario y falla con el mensaje “Couldn’t communicate with a helper application” cuando no existe ninguna (verificado en macOS 26.5). Las sesiones que solo usan SSH, los ejecutores de CI sin interfaz gráfica y los daemons de launchd se topan con esta limitación; ejecuta las invocaciones de agentes y las programadas dentro de una sesión de usuario iniciada: mediante un agente de launchd, no un daemon.

El contrato de invocación, en términos de agentes:12

Propiedad Valor
Descubrir shortcuts list --show-identifiers
Invocar shortcuts run <name-or-uuid> (prefiere los UUID; los nombres pueden cambiar)
Entrada -i con rutas de archivos o - para stdin
Salida -o - para stdout, --output-type <UTI> para forzar el formato
Señal de éxito Código de salida 0/11
Modos de fallo Salida distinta de cero o bloqueo indefinido ante una solicitud interactiva

Los datos estructurados cruzan el límite como texto. El patrón viable consiste en usar JSON mediante stdin/stdout: el proceso que llama envía un documento JSON (-i -), el shortcut lo analiza con Get Dictionary from Input, realiza su trabajo y termina con Stop and Output, que devuelve un diccionario como texto.116 El shortcut se convierte en una función tipada con un esquema documentado; conserva un README con la estructura de entrada y salida esperada de cada shortcut junto a la configuración del agente que lo invoque.

Los tiempos de espera son responsabilidad del proceso que llama. Como un shortcut que muestra una alerta pausa el proceso CLI indefinidamente,1 cualquier proceso desatendido debe imponer un tiempo límite a la invocación y considerar que su vencimiento es un fallo:

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

Prepara los permisos antes de dejar el proceso desatendido. Ejecuta cada shortcut de forma interactiva una vez y responde Always Allow a sus solicitudes; confirma desde una terminal que la ejecución no muestra solicitudes antes de que lo invoque un agente o una tarea de launchd.61 La sección sobre permisos explica qué autorizaciones estás concediendo de antemano.

Elige el punto de entrada según el tipo de proceso que llama. Los procesos con acceso al shell (agentes, CI, agentes de launchd y Makefiles, siempre dentro de una sesión iniciada) usan la CLI. Los contextos de Apple Events (aplicaciones AppleScript y daemons de PyObjC) usan Shortcuts Events y reciben valores de retorno nativos.11 Los contextos aislados o limitados a URL usan shortcuts://run-shortcut con x-callback para obtener los resultados.920 Los tres ejecutan el mismo shortcut; solo cambia el medio de transporte.

La dirección inversa también funciona: puedes usar los shortcuts como interfaces para agentes. Un shortcut asociado con una combinación de teclas o con un espacio en la barra de menús puede recopilar contexto (selección, portapapeles, aplicación en primer plano), pasarlo a Run Shell Script para invocar la CLI de tu agente y mostrar el resultado; así, las superficies de entrada del sistema operativo se convierten en la interfaz de usuario de las herramientas subyacentes.1017


Permisos y consentimiento (TCC)

Shortcuts hereda el modelo de seguridad de macOS basado en el consentimiento, y cualquier fallo de automatización que no sea un error lógico acaba remitiendo a este punto. El modelo consta de cuatro capas; si sabes cuál genera la solicitud, las correcciones se vuelven mecánicas.

1. Consentimiento de datos por shortcut. La primera vez que un shortcut accede a un recurso protegido, Shortcuts pregunta: “If a Privacy dialog appears requesting access to data, choose Allow Once, Always Allow, or Don’t Allow.” Always Allow significa que la aplicación Shortcuts no volverá a pedirte acceso la próxima vez que ejecutes el shortcut.6 Las autorizaciones se conceden por shortcut y por recurso, y pueden revisarse: el panel de detalles de cada shortcut incluye una pestaña Privacy donde puedes revocar autorizaciones individuales; para retirar el acceso de este shortcut a todos los datos, haz clic en Reset Privacy.6

2. El control de acceso a los scripts. Las cinco acciones de scripts solo se ejecutan si Settings → Advanced → Allow Running Scripts está activado (lista exacta anterior).8 Esta configuración es global, no específica de cada shortcut; activarla para un script de carpeta dinámica la habilita para todos los shortcuts importados, por lo que conviene revisar estos últimos antes de ejecutarlos.6

3. Solicitudes de TCC del sistema. Las acciones que acceden a áreas protegidas del sistema operativo (Files and Folders, Automation/Apple Events para controlar otras aplicaciones mediante scripts y Accessibility para controlar la entrada) activan los cuadros de diálogo del sistema, gestionados desde System Settings → Privacy & Security. Estos permisos se vinculan con el proceso responsable, por eso un shortcut puede comportarse de manera diferente en la aplicación, desde la CLI y dentro de una automatización: son contextos de inicio distintos y reciben autorizaciones por separado.6

4. Política de ejecución de automatizaciones. La configuración Run Immediately o Run After Confirmation de cada automatización determina si el propio activador requiere intervención humana.18

De este modelo se derivan las siguientes reglas operativas:

  • Las solicitudes no aparecen donde nadie puede verlas. Los contextos sin interfaz gráfica (sesiones de SSH, ejecutores de CI y agentes) heredan la primera regla de la sección sobre la CLI: un cuadro de diálogo de consentimiento sin responder provoca una pausa indefinida.1 Concede los permisos previamente de forma interactiva.
  • Reset Privacy es la herramienta de depuración para empezar desde cero. Cuando un shortcut funciona mal después de editarlo, restablecer sus permisos y volver a ejecutarlo de forma interactiva hace que todas las solicitudes reaparezcan en orden.6
  • Conviene revisar los shortcuts importados. Apple valida los shortcuts firmados para “Anyone”, pero “cannot verify the authenticity or behavior of shortcuts shared privately.”67 La pestaña Privacy muestra qué permisos se han concedido al shortcut y el editor muestra lo que hace. Revisar ambos solo toma un minuto.

Solución de problemas

Síntoma Causa probable Solución
shortcuts run se bloquea indefinidamente El shortcut muestra una alerta o solicita datos; la CLI se pausa mientras espera al usuario1 Rediseña el shortcut para que reciba parámetros mediante la entrada; aplica un tiempo límite a los procesos que lo invocan (gtimeout de coreutils; macOS no incluye timeout)
No se encuentra el shortcut desde la CLI El nombre no coincide o cambió shortcuts list --show-identifiers; invócalo mediante UUID2
Se ejecuta en la aplicación, pero falla desde la CLI o una automatización El consentimiento se concedió a un contexto de inicio, pero no al otro6 Ejecútalo una vez de forma interactiva en el contexto donde falla; responde Always Allow
La acción del script no hace nada Allow Running Scripts está desactivado8 Settings → Advanced → Allow Running Scripts
Falla la ejecución desde AppleScript/ScriptingBridge La aplicación anfitriona no tiene permiso de Automation para Shortcuts Events6 System Settings → Privacy & Security → Automation
El archivo .shortcut importado no se abre No está firmado, está restringido a contactos o Private Sharing está desactivado26 Pide al remitente que lo firme con -m anyone; revisa Settings → Advanced → Private Sharing
shortcuts sign -m anyone falla La notarización requiere iCloud2 Inicia sesión en iCloud e inténtalo de nuevo
La automatización de carpeta no se activa Las automatizaciones son locales para cada dispositivo; se configuró en otra Mac o el activador exige confirmación Vuelve a crearla en la Mac de destino; revisa Run Immediately318
La ruta de archivo enviada por una canalización llega como texto Las canalizaciones entregan texto, no archivos1 Usa -i para las entradas de archivos
El archivo de salida tiene un formato incorrecto El tipo se infirió a partir del nombre del archivo Establece --output-type con un UTI explícito12
La automatización se ejecutó, pero no ocurrió nada visible Se ejecutó sin interfaz gráfica por diseño Añade Show Notification como última acción mientras depuras
Las acciones de ventana afectan a la ventana equivocada Find Windows devolvió varias coincidencias Filtra u ordena los resultados en Find Windows; selecciona explícitamente el primer elemento16

Tarjeta de referencia rápida

# 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

Listas de verificación. Shortcut preparado para ejecutarse sin supervisión: no contiene alertas ni parámetros Ask Each Time; el consentimiento se concedió previamente con Always Allow; se invoca mediante UUID; el proceso que llama impone un tiempo límite; termina con Stop and Output.16 Archivo listo para distribuir: exportado, firmado con -m anyone y con su contrato de entrada documentado.27


Preguntas frecuentes

¿Cómo ejecuto un Shortcuts de Mac desde Terminal? shortcuts run "Shortcut Name", opcionalmente con -i para archivos de entrada (o - para stdin), -o para la salida (o - para stdout) y --output-type con un Uniform Type Identifier. El comando termina con 0 cuando tiene éxito y con 1 cuando ocurre un error, por lo que se combina con &&, if y make como cualquier herramienta Unix.12

¿macOS por fin tiene automatizaciones de Shortcuts como iOS? Sí, desde macOS Tahoe (26). Los activadores incluyen Hora del día, Alarma, Correo electrónico, Mensaje, cambios en Carpeta, Unidad externa, Pantalla, Wi-Fi, Bluetooth, Nivel de batería, Cargador, apertura o cierre de apps, Focus y Stage Manager; cada uno se puede configurar para ejecutarse de inmediato o después de una confirmación.3418

¿Qué hace realmente shortcuts sign -m anyone? Notariza el archivo del shortcut mediante iCloud para que cualquiera pueda importarlo. El modo predeterminado, people-who-know-me, firma localmente y restringe la importación a tus propios dispositivos y a las personas que tienen tu información de contacto en Contacts.2

¿Cómo agregan las apps sus propias actions a Shortcuts en Mac? Adoptando el framework App Intents. Los intents aparecen automáticamente como actions de Shortcuts, y un AppShortcutsProvider incluye App Shortcuts que no requieren configuración junto con la app. Los intents disponibles en macOS también se ejecutan desde Spotlight y dentro de las automatizaciones de Tahoe, incluidos los intents de apps de iOS instaladas en Mac con Apple silicon.134

¿Cómo debería invocar Shortcuts un script o agente de IA? Usa el CLI: descubre con shortcuts list --show-identifiers, invoca mediante UUID, pasa JSON por stdin, lee los resultados desde stdout y envuelve cada llamada en un tiempo de espera, porque un shortcut que solicita algo se pausará para siempre (macOS no incluye timeout(1); usa gtimeout de coreutils o el tiempo de espera de procesos de tu lenguaje). Autoriza previamente de forma interactiva las solicitudes de permisos de cada shortcut antes de usarlos sin supervisión. Desde contextos de AppleScript, dirígete a Shortcuts Events para ejecutarlos sin abrir la app.1211

¿Puede Shortcuts reemplazar a Automator? Para la mayoría de los flujos de trabajo, sí; Apple llama a Shortcuts el futuro de la automatización en Mac y creó un convertidor que importa directamente la mayoría de los archivos .workflow. Automator sigue incluido y continúa ejecutando los flujos de trabajo existentes, así que migrar es una decisión, no una fecha límite.51415


Registro de cambios

Fecha Cambio Fuente
2026-08-16 Tres correcciones frente al propio artículo de Apple ya citado, además de que el seguimiento de macOS 27 pasa a fuentes primarias. A la tabla de activadores de automatización le faltaba File («When my file is modified»), que el artículo de soporte 125148 enumera por separado de Folder: un error presente desde la v1.0 frente a una fuente que la guía ya cita. Se agregó Control Center a la tabla de puntos de entrada («Run Shortcut, Open App, and Show ‘Menu Bar’ Collection») y se registró que los shortcuts ejecutados desde Spotlight ahora pueden aceptar entrada, como texto seleccionado de un documento abierto. La beta 5 de macOS 27 (2026-08-10) ahora incluye una sección real de Shortcuts en las notas de lanzamiento de Apple, lo que reemplaza el seguimiento prospectivo anterior de esta guía basado en fuentes secundarias: una corrección para la action Use Model, que fallaba con la opción On-Device (181071784), y dos problemas conocidos: editar un shortcut creado con intents mediante «Describe a change» puede fallar cuando el intent usa Duration o LPLinkMetadata (166068090), y las automatizaciones de Battery Level y Charger podrían no funcionar en macOS (180337087), lo que afecta dos filas de la tabla de activadores en la beta 27. La sesión 310 de WWDC26 documenta valores persistentes de Storage (sincronizados con iCloud y compartidos entre shortcuts), un inspector de transcripciones de Use Model y tipos de automatización Screenshot / Keyboard / Notification. Apple no indica disponibilidad en macOS para esos tres activadores y las notas de macOS 27 no los enumeran, por lo que permanecen fuera de la tabla de activadores de Mac hasta que aparezca una fuente específica para Mac. La versión distribuida de macOS ahora es 26.6.2 (25G82); no existen notas de lanzamiento para desarrolladores de 26.6.1/26.6.2, por lo que no hay cambios documentados de Shortcuts. Se verificó que no hubo cambios en el material sobre CLI, signing, Shortcuts Events, URL scheme y permisos. 322
2026-07-27 Revisión de actualidad, sin cambios en el contenido. macOS Tahoe 26.6 (25G72) se lanzó de forma estable el 27 de julio de 2026, cerrando el ciclo beta que vigilaba la fila anterior. Las notas de lanzamiento de Apple para 26.6 enumeran cuatro elementos —una descontinuación de CoreStorage (Encrypted HFS+ pierde compatibilidad en macOS 28), una corrección de Ecosystem para avisos de descontinuación que interpretaban erróneamente una app anfitriona como compatible solo con Intel cuando un plugin carga código x86, una corrección de estadísticas de HealthKit y una corrección de capturas HDR de Messages— y no mencionan cambios en Shortcuts, WorkflowKit ni App Intents, por lo que todas las afirmaciones sobre el catálogo, CLI y las automatizaciones de esta guía siguen vigentes sin cambios. El contenido aún dice «verificado en macOS 26.5» deliberadamente: allí fue donde se inspeccionaron directamente la tabla de cadenas de WorkflowKit y shortcuts(1), y todavía no se ha vuelto a inspeccionar en 26.6. macOS 27 «Golden Gate» sigue siendo el seguimiento prospectivo. 23
2026-07-21 Revisión de actualidad, sin cambios en el contenido. macOS Tahoe distribuido sigue siendo Shortcuts 7.0 (verificado en 26.5.2; las betas de 26.6 fueron versiones de mantenimiento sin cambios en Shortcuts ni App Intents). Seguimiento prospectivo: la primera beta pública de macOS 27 «Golden Gate» (13 de julio de 2026) anticipa la app Shortcuts de próxima generación: creación en lenguaje natural «Describe a Shortcut» mediante Apple Intelligence, con el editor manual conservado y una opción predeterminada que el usuario puede elegir entre ambos, además de extensiones de Safari creadas con IA a partir de descripciones. Las funciones beta pueden cambiar antes del lanzamiento aproximado de septiembre; la actualización del contenido llegará cuando se distribuya macOS 27. Cobertura de la beta pública de MacRumors/MacStories, 13 de julio de 2026
2026-07-07 Guía v1.0: lanzamiento inicial sobre Shortcuts 7.0 en macOS 26 (Tahoe). Catálogo de actions verificado frente a WorkflowKit en macOS 26.5; CLI verificado frente a shortcuts(1); automatizaciones, Use Model y ejecución desde Spotlight según la documentación de Apple y la sesión 260 de WWDC25; diccionario de Shortcuts Events inspeccionado mediante sdef. 12341116

Referencias


  1. Apple, “Ejecutar atajos desde la línea de comandos”, Guía del usuario de Shortcuts para Mac. Fuente principal sobre el comportamiento de CLI: el ejemplo de Combine Images, la canalización stdin/stdout, la advertencia de que la canalización entrega texto, el tipo de salida mediante Uniform Type Identifier, el estado de salida («El comando shortcuts saldrá con 0 si la ejecución se completa correctamente o con 1 si hay un error») y la indicación de que los atajos que muestran alertas pausan el proceso de línea de comandos mientras esperan una entrada. 

  2. Página de manual de shortcuts(1) y salida de shortcuts help <subcommand>, verificadas en macOS 26.5 (Shortcuts 7.0). Fuente principal para los cuatro subcomandos y todas las opciones: run (--input-path con - para stdin, --output-path con - para stdout, --output-type en formato UTI), list (--folder-name, --folders, --show-identifiers), view y sign (valores de --mode: anyone y people-who-know-me; anyone notariza mediante iCloud y people-who-know-me firma localmente con importación restringida a contactos). 

  3. Apple, “Novedades de Shortcuts para iOS, iPadOS, macOS, watchOS y visionOS 26”, Apple Support. Fuente principal sobre la llegada de las automatizaciones personales a macOS con el ciclo de lanzamiento 26 y la lista de eventos (hora del día, correo electrónico o mensaje de personas específicas, cambios en carpetas, conexión o desconexión de unidades externas, Wi-Fi, conexión de dispositivos Bluetooth, conexión o desconexión de pantallas, apertura o cierre de apps). 

  4. Apple, “Desarrolla para Shortcuts y Spotlight con App Intents” (sesión 260 de WWDC25). Fuente principal para la acción Use Model (opciones de modelos Private Cloud Compute, en el dispositivo y ChatGPT; tipos de salida de texto, diccionario y entidades de app; el interruptor Follow Up), la ejecución de app intents desde Spotlight en Mac (requisitos del resumen de parámetros, isDiscoverable/assistantOnly, orientación sobre consultas de entidades), las automatizaciones en Mac («automatizaciones de carpetas y unidades externas diseñadas específicamente para Mac») y la afirmación de que los intents disponibles en macOS se ejecutan en automatizaciones «incluidas las apps de iOS que se pueden instalar en macOS». 

  5. Apple, “Conoce Shortcuts para macOS” (sesión 10232 de WWDC21). Fuente principal para la introducción en Monterey: «Shortcuts es el futuro de la automatización en Mac», la implementación con SwiftUI, la sincronización mediante iCloud de bibliotecas existentes, la herramienta de migración de Automator («puede convertir la mayoría de los flujos de trabajo de Automator en Shortcuts»), la posibilidad de que cualquier app de Mac proporcione acciones y la compatibilidad inicial con scripts de shell + AppleScript. 

  6. Apple, “Ajustar la configuración de privacidad en Shortcuts en Mac”, Guía del usuario de Shortcuts para Mac. Fuente principal para el flujo de consentimiento Allow Once / Always Allow / Don’t Allow, la pestaña Privacy por atajo y Reset Privacy, la ubicación de la configuración Advanced (incluidos Allow Sharing Large Amounts of Data y Private Sharing), y la advertencia de que «Apple no puede verificar la autenticidad ni el comportamiento de los atajos compartidos de forma privada». 

  7. Apple, “Compartir atajos en Mac”, Guía del usuario de Shortcuts para Mac. Fuente principal para compartir enlaces de iCloud, File → Export y las opciones de acceso: Anyone («Cualquiera puede ejecutar tu atajo», y Apple recibe una copia para validarla) y People Who Know Me («Solo las personas que te tengan en sus contactos podrán ejecutar tu atajo», con información de contacto incluida en el archivo). 

  8. Apple, “Configuración avanzada de Shortcuts en Mac”, Guía del usuario de Shortcuts para Mac, además de la descripción de la configuración dentro de la app verificada en macOS 26.5: «Cuando está activada, se pueden ejecutar las acciones “Run AppleScript”, “Run Shell Script”, “Run JavaScript for Mac Automation”, “Run JavaScript on Web Page” y “Run Script Over SSH”». Fuente para la restricción Allow Running Scripts y su advertencia sobre pérdida de datos. 

  9. Apple, “Ejecutar un atajo desde una URL en Mac”, Guía del usuario de Shortcuts para Mac. Fuente principal para la sintaxis shortcuts://run-shortcut, los parámetros name, input (text o clipboard) y text, ambos ejemplos documentados y la indicación de usar la acción Run Shortcut en lugar de URL al invocar atajos desde otros atajos. 

  10. Apple, “Ejecutar un atajo mientras trabajas en tu Mac”, Guía del usuario de Shortcuts para Mac. Fuente para Quick Actions (Use as Quick Action, Control-clic en Finder), la opción del menú Services, los atajos de teclado por atajo mediante Add Keyboard Shortcut y la invocación desde la barra de menús. 

  11. Diccionario de scripting de Shortcuts Events, inspeccionado mediante sdef "/System/Library/CoreServices/Shortcuts Events.app" en macOS 26.5; identificador de paquete com.apple.shortcuts.events obtenido del Info.plist de la app. Fuente principal para el comando run con with input y resultado, la nota de ejecución en segundo plano («Para ejecutar un atajo en segundo plano, sin abrir la app Shortcuts, indica “Shortcuts Events” en lugar de “Shortcuts”»), las propiedades de los atajos (nombre, subtítulo, id, carpeta, color, icono, acepta entrada, cantidad de acciones), los objetos de carpeta y los grupos de acceso com.apple.shortcuts.run / com.apple.shortcuts.organize

  12. Apple, “Introducción a Shortcuts en Mac”, Guía del usuario de Shortcuts para Mac. Fuente para las definiciones de acción/atajo y el uso entre dispositivos de atajos creados en una Mac. 

  13. Apple, documentación del framework App Intents, Apple Developer. Fuente para el papel del framework (exponer acciones y contenido de apps a Shortcuts, Siri, Spotlight, widgets y Apple Intelligence), los tipos AppIntent/AppEntity/AppShortcutsProvider y la disponibilidad en plataformas desde iOS 16 y macOS 13. 

  14. Apple, “Importar flujos de trabajo de Automator a la app Shortcuts en Mac”, Guía del usuario de Automator. Fuente principal para arrastrar y convertir, y para «Shortcuts puede convertir la mayoría de los flujos de trabajo de Automator en atajos que realizan las mismas funciones, eventos y automatizaciones». 

  15. Apple, “Importar atajos en Mac”, Guía del usuario de Shortcuts para Mac. Fuente para la mecánica de importación de .shortcut (doble clic, arrastrar a la app o al Dock) y la conversión de .workflow al importar, incluido Open With → Shortcuts. 

  16. Tabla de cadenas en inglés del framework WorkflowKit (Localizable.loctable, /System/Library/PrivateFrameworks/WorkflowKit.framework), inspeccionada en macOS 26.5 (Shortcuts 7.0). Fuente principal para los nombres literales de acciones citados en el catálogo (361 entradas distintas, entre ellas Find Windows, Move Window, Resize Window, Split Screen Apps, Run Shortcut, Stop and Output, Get My Shortcuts, Use Model y Watch Me Do), los resúmenes de parámetros de Move/Resize Window y las posiciones de ventana (Full Screen, Left, Right, tercios, Bottom Leading/Trailing), y las descripciones de los modos de entrada de Run Shell Script («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.»). La tabla incluye nombres de acciones solo para iOS y heredadas de la época de Workflow; las tablas del catálogo de esta guía enumeran únicamente acciones relevantes para Mac. 

  17. Parámetros de la acción Run Shell Script (selección de shell, modo de entrada, paso por stdin/argumentos), según las cadenas de documentación del editor de la acción verificadas en macOS 26.5; consulta también 16

  18. MacMost, “Una introducción a la automatización de Shortcuts en macOS Tahoe”. Fuente secundaria que corrobora la lista completa de activadores de Tahoe (incluidos Alarm, Battery Level, Charger, Focus y Stage Manager) y las opciones Run Immediately frente a Run After Confirmation; las categorías de activadores principales se detallan en 3 y 4

  19. Info.plist de Shortcuts.app, verificado en macOS 26.5: esquemas de URL registrados shortcuts y workflow (además del interno shortcuts-production) y tipos de documento com.apple.shortcut y com.apple.shortcuts.workflow-file

  20. Apple, “Usar x-callback-url con Shortcuts en Mac”, Guía del usuario de Shortcuts para Mac. Fuente principal para la sintaxis de ejecución de x-callback-url y los parámetros x-success (con result añadido), x-error (con errorMessage) y x-cancel

  21. Apple, “Usar automatizaciones de Shortcuts en Apple Configurator para Mac”, Guía del usuario de Apple Configurator. Fuente para la compatibilidad con automatizaciones de Shortcuts en dispositivos administrados. 

  22. Apple, “Notas de la versión de macOS 27” (Golden Gate Beta 5, 2026-08-10), leídas desde el JSON de DocC porque la página de HTML se renderiza del lado del cliente. Sección de Shortcuts, literalmente — resuelto: «Fixed: The Use Model action might fail to run when using the On-Device option for some output types. (181071784)»; problemas conocidos: «If an app intent uses Duration or LPLinkMetadata, creating a shortcut with that intent and then attempting to edit it with "Describe a change" might fail. (166068090)» y «Battery Level and Charger automations might not work on macOS. (180337087)». El almacenamiento, el inspector de transcripciones de Use Model y los tipos de automatización Screenshot / Keyboard / Notification provienen de Apple, “Novedades de Shortcuts”, sesión 310 de WWDC26, junio de 2026; la sesión no indica la disponibilidad en macOS de esos tres activadores. Fecha de la beta cotejada con Apple Developer Releases. Verificado el 2026-08-16. 

  23. Apple, “Notas de la versión de macOS Tahoe 26.6”, y la lista de Releases, que fecha macOS 26.6 (25G72) el 27 de julio de 2026 junto con iOS/iPadOS 26.6 (23G71), tvOS 26.6 (23L773), visionOS 26.6 (23O770) y watchOS 26.6 (23U67). Leídas mediante el renderizado DocC JSON en developer.apple.com/tutorials/data/documentation/macos-release-notes/macos-26_6-release-notes.json el 2026-07-27, porque la página de HTML se renderiza del lado del cliente y no devuelve texto a un extractor. El documento contiene exactamente cuatro entradas, bajo CoreStorage (Deprecations, radar 175892336), Ecosystem (Resolved Issues, 174841181 / FB22512943), HealthKit (Resolved Issues, 178157672) y Messages (Resolved Issues, 180859837). Las búsquedas sin distinción entre mayúsculas y minúsculas en todo el JSON de shortcut, workflowkit, app intents, appintents y automation devuelven cero coincidencias. Ten en cuenta que el texto Overview de la propia página aún dice «macOS Tahoe 26.6 RC»: Apple no lo había retitulado al momento de esta verificación, aunque la lista de Releases muestra que la compilación ya se distribuyó. 

NORMAL shortcuts.md EOF