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

Automação com Atalhos no Mac: Referência para Profissionais (2026)

# Apple Shortcuts no macOS: o catálogo de ações, os gatilhos de automação, a CLI shortcuts, assinatura, App Intents e a execução de atalhos por scripts e agentes.

author: words: 11774 read_time: 45m updated: 2026-08-17 01:48
$ less shortcuts.md

TL;DR: Shortcuts está presente em todos os Macs desde o macOS Monterey (2021), e o macOS Tahoe (26) finalmente trouxe o recurso que quem automatiza tarefas no Mac esperou por quatro anos: automações pessoais com gatilhos como alterações em pastas, unidades externas, Wi-Fi, monitores e abertura de apps.34 O app executa atalhos pela barra de menus, pelo Spotlight, pelas Ações Rápidas do Finder, por atalhos de teclado e por uma verdadeira ferramenta de linha de comando (shortcuts run, list, view, sign).12 Qualquer app pode adicionar actions por meio do framework App Intents, a mesma interface usada por Siri, Spotlight e Apple Intelligence.13 Scripts e agentes de IA acionam atalhos de três maneiras: pelo CLI, pelo URL scheme shortcuts:// e pelo processo em segundo plano programável Shortcuts Events.1911 O modelo de permissões é a primeira parte que você precisa aprender: solicitações de consentimento imperceptíveis no app interrompem silenciosamente uma execução sem supervisão.

A Apple disse aos desenvolvedores que “Shortcuts é o futuro da automação no Mac” na WWDC 2021.5 Esse futuro chegou em duas etapas. A primeira foi lançada imediatamente: um app nativo em SwiftUI no macOS Monterey com sincronização pelo iCloud, uma ferramenta de migração do Automator e suporte completo a shell scripts e AppleScript dentro do editor.5 A segunda levou mais quatro versões do macOS. Até o macOS Tahoe, um atalho no Mac só era executado quando algo o acionava; não havia gatilhos, então “automação” significava lembrar de clicar. O Tahoe resolveu essa lacuna com automações pessoais criadas para o Mac (gatilhos de pasta e unidade externa), além das opções já conhecidas do iOS (Hora do Dia, Bluetooth), e adicionou uma action Use Model que coloca o Apple Intelligence no meio do fluxo de dados de um atalho.34

O resultado é um sistema que vale a pena conhecer bem. Shortcuts no Mac em 2026 reúne quatro funções:

  1. Um editor no-code com centenas de actions integradas, desde operações com arquivos e gerenciamento de janelas até IA no dispositivo
  2. Um mecanismo de automação com gatilhos de eventos do sistema, novidade do macOS Tahoe
  3. Uma ferramenta de linha de comando de verdade: shortcuts run funciona como qualquer outra ferramenta Unix, com stdin, stdout, códigos de saída e pipes1
  4. Um registro de actions para todos os apps: tudo o que um app disponibiliza por meio de App Intents aparece automaticamente no Shortcuts, tanto no Mac quanto nas demais plataformas134

A diferença entre o uso casual e o avançado se resume a cinco sistemas: o catálogo de actions (o que existe), os gatilhos de automação (quando as tarefas são executadas), o CLI e as interfaces de scripting (como o código faz chamadas), a assinatura e o compartilhamento (como os atalhos são distribuídos) e o modelo de permissões (por que as execuções sem supervisão param). Cada um deles tem sua própria parte abaixo.

Todas as afirmações deste guia se baseiam na documentação da Apple, em sessões da WWDC ou na inspeção direta do macOS 26.5 (Shortcuts 7.0) na máquina em que o texto foi escrito. Quando uma informação veio do próprio sistema operacional (a página de manual shortcuts(1), o dicionário de scripting do Shortcuts Events ou as actions do framework WorkflowKit), isso é indicado na citação.


Principais conclusões

  • As automações são o grande destaque. O macOS Tahoe trouxe automações pessoais ao Mac: alterações em pastas, unidades externas, telas, Wi-Fi, Bluetooth, Stage Manager, abertura/encerramento de apps, horário do dia e muito mais, cada uma podendo ser executada imediatamente ou após confirmação.34
  • O CLI é de verdade, não é um brinquedo. shortcuts run "Name" -i input -o output oferece suporte a stdin (-i -), stdout (-o -), saída tipada por meio de Uniform Type Identifiers e códigos de saída 0 em caso de sucesso e 1 em caso de erro. Use-o em pipes como qualquer ferramenta Unix.12
  • Três pontos de entrada para scripts, uma regra. Use o CLI em shells e CI, o URL scheme shortcuts:// somente a partir de outros apps e Shortcuts Events (AppleScript/ScriptingBridge) quando você precisar receber resultados em um contexto de script sem abrir o app.1911
  • A assinatura controla a distribuição. Um arquivo .shortcut precisa ser assinado para ser compartilhado: shortcuts sign -m anyone faz a notarização pelo iCloud para que qualquer pessoa possa importá-lo; o modo padrão people-who-know-me assina localmente e limita a importação a pessoas que têm você nos Contatos.27
  • App Intents é a superfície para desenvolvedores. Um app que inclui App Intents recebe actions do Shortcuts no Mac sem custo adicional, e essas mesmas intents alimentam o Spotlight e as automações, incluindo apps para iOS instalados em Macs com Apple silicon.413
  • O consentimento é o modo de falha. O Shortcuts pergunta Permitir uma vez / Permitir sempre / Não permitir para cada atalho e tipo de dado. Actions que executam scripts ficam atrás de uma chave global “Permitir execução de scripts”. Uma execução sem interface que encontra um aviso ainda sem resposta simplesmente espera.168

Como usar este guia

Você é… Comece aqui Depois, explore
Novo no Shortcuts para Mac O que é o Shortcuts no Mac, Formas de executar um atalho O catálogo de actions, Gatilhos de automação no macOS
Veterano de Automator ou AppleScript Shortcuts vs Automator vs AppleScript, Actions de script O CLI do shortcuts, Controlando o app com Shortcuts Events
Desenvolvedor que expõe recursos do app App Intents: como os apps adicionam actions Spotlight e automações executam suas intents, Controlando o Shortcuts por scripts e agentes
Conectando atalhos a agentes ou CI O CLI do shortcuts, Controlando o Shortcuts por scripts e agentes Permissões e consentimento, Solução de problemas

Sumário

Parte 1: Fundamentos

  1. O que é o Shortcuts no Mac
  2. Formas de executar um atalho
  3. Shortcuts vs Automator vs AppleScript

Parte 2: Actions

  1. Como as actions se combinam
  2. O catálogo de actions
  3. Actions de script
  4. Actions de gerenciamento de janelas
  5. A action Use Model

Parte 3: Automações

  1. Gatilhos de automação no macOS
  2. Padrões de automação que funcionam

Parte 4: A linha de comando e URL schemes

  1. O CLI do shortcuts
  2. Controlando o app com Shortcuts Events
  3. URL schemes

Parte 5: Compartilhamento e distribuição

  1. Formatos de compartilhamento e assinatura

Parte 6: A superfície para desenvolvedores

  1. App Intents: como os apps adicionam actions
  2. Spotlight e automações executam suas intents
  3. Controlando o Shortcuts por scripts e agentes

Parte 7: Operações e referência

  1. Permissões e consentimento (TCC)
  2. Solução de problemas
  3. Cartão de referência rápida
  4. Perguntas frequentes
  5. Registro de alterações
  6. Referências

O que é o Shortcuts no Mac

Shortcuts é o app de automação da Apple: você encadeia actions (etapas com uma única finalidade) em um atalho (um workflow salvo) e o executa por clique, voz, atalho de teclado, gatilho ou linha de comando. Vale ter em mente a definição da própria Apple, pois ela explica todo o design: “Uma action é o bloco de construção de um atalho. Cada atalho é composto por uma série de actions, e cada action é uma única etapa que executa uma função específica.”12

O app chegou ao Mac com o macOS Monterey em 2021, portado do iOS, mas escrito quase inteiramente em SwiftUI para que a mesma base de código atendesse às duas plataformas.5 Três decisões de design daquela primeira versão ainda definem a experiência no Mac em 2026:

  • A sincronização pelo iCloud é o padrão. Abra o Shortcuts em um novo Mac e sua biblioteca existente será exibida, sincronizada do iPhone e do iPad. Um atalho criado em um dispositivo é executado nos demais, exceto pelas actions específicas de cada plataforma.512
  • Os apps fornecem actions. “Assim como no iOS, qualquer app no Mac pode fornecer actions ao Shortcuts.”5 Em 2026, esse fluxo é o framework App Intents, abordado na Parte 6.
  • Scripts são cidadãos de primeira classe. O Monterey trouxe “suporte completo para AppleScripts e Shell Scripting”, com “novas actions, integradas diretamente ao Shortcuts, que permitem escrever e executar scripts no editor do Shortcuts”, portanto o Shortcuts envolve a pilha de automação anterior em vez de substituí-la.5

O que o Monterey não trouxe foram gatilhos. De 2021 a 2024, um atalho no Mac era executado apenas quando algo o invocava. O macOS Tahoe (26) mudou isso em 2025 ao trazer automações pessoais para o Mac, com tipos de gatilho criados especificamente para workflows de desktop (conteúdo de pasta alterado, unidade externa conectada), além do conjunto já estabelecido no iOS.34 O Tahoe também adicionou a action Use Model, que envia dados pelos modelos do Apple Intelligence durante a execução do atalho.34

Marcos de versão:

macOS Ano O que adicionou ao Shortcuts
Monterey (12) 2021 App Shortcuts, CLI shortcuts, importação do Automator, actions de script, integração com a barra de menus e Quick Action52
Ventura até Sequoia (13–15) 2022–2024 App Intents substitui a infraestrutura antiga de intents como superfície para desenvolvedores; App Shortcuts aparecem sem configuração13
Tahoe (26) 2025 Automações pessoais no Mac, action Use Model (Apple Intelligence), app intents executáveis pelo Spotlight34

Ao longo do guia, “verificado no macOS 26.5” significa que foi conferido diretamente no Shortcuts 7.0 no Mac usado para escrevê-lo.


Formas de executar um atalho

O Shortcuts no Mac é excepcionalmente generoso em pontos de entrada. Todos os itens a seguir invocam o mesmo atalho; eles diferem na origem da entrada e no destino da saída.1210

Ponto de entrada Como Melhor para
App Shortcuts Clique duas vezes no atalho ou clique em ▶ Criar e testar
Barra de menus Adicione o atalho à categoria da barra de menus e execute-o pelo ícone do Shortcuts na barra de menus Utilitários usados com frequência
Quick Actions (Finder) Ative “Use as Quick Action” nos detalhes do atalho e, depois, faça Control-clique em um arquivo → Quick Actions Atalhos de processamento de arquivos que recebem seleções do Finder como entrada10
Menu Serviços Ative “Services Menu” nos detalhes; aparece em menu do app → Serviços Atalhos orientados por texto ou seleção em qualquer app10
Atalho de teclado Painel de detalhes → Add Keyboard Shortcut, pressione uma combinação Tudo o que você executa muitas vezes por dia10
Spotlight Digite o nome do atalho e execute-o diretamente; um atalho executado assim pode aceitar uma entrada, como texto selecionado em um documento aberto Execução com foco no teclado sem reservar uma tecla de atalho34
Control Center Adicione um atalho como um controle — Run Shortcut, Open App ou Show “Menu Bar” Collection Acesso com um clique pelo Control Center ou pela barra de menus3
Siri Diga o nome do atalho Uso sem as mãos
Dock Arraste um atalho para fora do app até o Dock Iniciadores com um clique
Automações Baseadas em gatilhos, macOS Tahoe e versões posteriores Execuções sem supervisão (Parte 3)
Linha de comando shortcuts run "Name" Scripts, Makefiles, CI, agentes (Parte 4)
URL scheme shortcuts://run-shortcut?name=... Invocação a partir de outros apps9
Shortcuts Events AppleScript/ScriptingBridge, sem interface Execuções em segundo plano com resultados retornados ao chamador11

Dois detalhes economizam tempo mais adiante. Primeiro, as entradas Quick Action e Serviços recebem a seleção atual como entrada do atalho, por isso atalhos de processamento de arquivos devem declarar os tipos de entrada aceitos (a configuração “Receive” do editor), em vez de presumir texto. Segundo, as três últimas linhas são a superfície programável; elas têm suas próprias seções porque seus contratos de entrada e saída diferem.

Shortcuts vs Automator vs AppleScript

Os três sistemas de automação da Apple ainda acompanham o macOS em 2026 (o Automator continua em /System/Applications, conforme verificado no macOS 26.5), e cada um ainda tem sua função. A perspectiva que continua válida é: Shortcuts funciona como a camada de integração, AppleScript é a linguagem de controle de apps e os scripts de shell formam a camada de computação. O Automator está em modo de manutenção: funcional, inalterado e oficialmente sucedido pelo Shortcuts.514

Shortcuts Automator AppleScript / JXA Scripts de shell
Modelo Actions + gatilhos, sincronizados pelo iCloud Actions em documentos .workflow Linguagem que envia Apple Events para apps Processos Unix
Integração com apps App Intents (moderno e em expansão) Plugins de actions legados (congelados) Dicionários de scripts (avançados, mas dependentes do app) Apenas CLIs
Gatilhos Automações pessoais (Tahoe+)3 Folder Actions, alarmes do Calendar Nenhum integrado cron, launchd
Também funciona no iPhone/iPad Sim12 Não Não Não
Status em 2026 Em desenvolvimento ativo Mantido, sem novos investimentos Mantido Sempre atual

O caminho de migração existe, mas há perdas nas situações mais específicas. A Apple incorporou um conversor ao Shortcuts: arraste um arquivo .workflow para o app (ou clique com a tecla Control pressionada → Open With → Shortcuts) e “o Shortcuts pode converter a maioria dos fluxos de trabalho do Automator em shortcuts que executam as mesmas funções, eventos e automações”.1415 “Maioria” é a palavra usada pela Apple e, na prática, significa que actions padrão para arquivos, imagens e texto são convertidas sem problemas; a conversão perde qualidade em actions pouco comuns de terceiros para o Automator e gravações do Watch Me Do. O Shortcuts até preserva internamente o nome da action Watch Me Do como parte dessa compatibilidade (visível na tabela de actions do framework, conforme verificado no macOS 26.5).16

Quando ir além do Shortcuts. O controle avançado de cada app (percorrer mensagens do Mail, manipular janelas do Finder por código ou controlar apps com dicionários de scripts completos) ainda é o território do AppleScript. Processamento complexo de texto, orquestração de API e qualquer coisa que você já escreveria em Python ou zsh devem ficar em um script. Na prática, a melhor escolha é combinar as ferramentas, não ser fiel a uma só: um shortcut que recebe dados de um gatilho, os encaminha para um script de shell fazer o trabalho pesado e usa actions nativas para notificações e organização de arquivos aproveita o melhor de cada sistema. A seção Scripting Actions explica os mecanismos.


Como as Actions se combinam

Todo shortcut é um pipeline. Cada action recebe uma entrada (geralmente a saída da action anterior), faz uma coisa e produz uma saída. Três mecanismos tornam o pipeline versátil:

  • Magic variables. A saída de cada action fica automaticamente disponível como variável para as actions seguintes, sem que você precise declarar nada. Clique em um campo de parâmetro, escolha Select Magic Variable e selecione a saída de qualquer action anterior. Set Variable e Get Variable permitem atribuir nomes explícitos, enquanto Add to Variable acumula listas (as três são actions integradas, conforme verificado no macOS 26.5).16
  • Tipos de conteúdo, convertidos sob demanda. As actions declaram o que aceitam (arquivos, imagens, texto, URLs, datas). Quando os tipos da saída e da entrada são diferentes, o Shortcuts faz a conversão quando possível: passe uma página da web para uma action de texto e você receberá o texto da página. A configuração “Receive”, exibida na parte superior do editor de um shortcut, define o que o shortcut inteiro aceita de Quick Actions, Services ou do --input-path do CLI.
  • Controle de fluxo como actions. If, Repeat, Repeat with Each, Choose from Menu, Wait to Return, Stop This Shortcut e Stop and Output são actions comuns.16 Stop and Output é mais importante no Mac do que em qualquer outra plataforma: ela define o que um shortcut retorna para a linha de comando, um pipe ou um script que o chamou.1

O elemento básico da composição é Run Shortcut: um shortcut chama outro pelo nome e fornece uma entrada.16 A orientação da Apple deixa claro que o aninhamento deve usar a action, não URL schemes: “Se você quiser executar um shortcut a partir de outro, use a action Run Shortcut em vez de um URL scheme.”9 Trate shortcuts como funções: shortcuts pequenos e com uma única finalidade (normalizar o nome de um arquivo, enviar dados para um webhook, redimensionar uma imagem para miniatura), combinados por um shortcut coordenador, escalam muito melhor do que um monólito de 60 actions, e cada parte continua podendo ser testada de forma independente pelo CLI.


O catálogo de Actions

A biblioteca integrada é grande: a tabela de strings em inglês no framework WorkflowKit do macOS 26.5 (o framework privado por trás do Shortcuts) lista 361 nomes distintos de actions.16 Esse número é maior do que o total exibido no editor: a tabela inclui actions exclusivas do iOS e integrações legadas herdadas da época em que o app se chamava Workflow. A seguir está o catálogo relevante para o Mac, organizado de acordo com o que as pessoas realmente procuram ao criar automações. Todos os nomes de actions abaixo aparecem exatamente dessa forma na tabela, conforme verificado no macOS 26.5.16

Arquivos e Finder

Action O que faz
Get File from Folder / Get Contents of Folder Lê arquivos ou listas de conteúdo de pastas
Save File / Move File / Rename File / Delete Files / Label Files Gerencia o ciclo de vida dos arquivos
Create Folder / Get Parent Directory / Get Link to File Gerencia a estrutura de pastas
Filter Files / Get Details of Files Consulta por nome, extensão, data ou tamanho
Get Selected Files in Finder / Reveal Files in Finder Faz a integração com a seleção do Finder
Make Archive / Extract Archive Compacta e descompacta arquivos
Make Disk Image / Mount Disk Image / Eject Disk Gerencia imagens de disco e volumes
Append to Text File Faz gravações no estilo de logs

Sistema e apps

Action O que faz
Open App / Quit App / Hide App Gerencia o ciclo de vida dos apps
Split Screen Apps Organiza dois apps lado a lado
Set Focus / Get Current Focus Gerencia modos Focus
Set Volume / Play Sound / Start Screen Saver Controla recursos do ambiente
Show Notification / Speak Text Fornece canais de feedback
Get Device Details / Get Network Details / Get Current IP Address Consulta o ambiente
Get Details of Appearance Verifica se a aparência está no modo claro ou escuro
Print / Quick Look Envia a saída para impressão ou pré-visualização

Web e dados

Action O que faz
Get Contents of URL O cliente HTTP: usa GET por padrão, com método, cabeçalhos e corpo configuráveis para chamadas de API
Get Contents of Web Page / Get Article using Safari Reader Extrai conteúdo de páginas
Get Current Web Page from Safari Integração com o Safari (veja também Run JavaScript on Web Page, em Scripting Actions)
Get Headers of URL / Get Component of URL / URL Encode Gerencia HTTP e URLs
Get Items from RSS Feed / Get RSS Feeds from Page Gerencia feeds
Get Dictionary from Input / Get Text from Input / Set Dictionary Value JSON como entrada, JSON como saída
Generate Hash / Base64 Encode Utilitários de codificação

Get Contents of URL, em conjunto com as actions Dictionary, forma um cliente REST funcional: faça a solicitação, processe o JSON e extraia valores, sem escrever código. Quando os payloads ficarem complexos, transfira o trabalho para um script de shell com curl e jq em vez de lutar com dicionários aninhados no editor.

Texto, imagens e mídia

Action O que faz
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 Converte formatos
Get Text from PDF / Extract Text from Image / Make PDF / Split PDF Into Pages / Optimize File Size of PDF Processa documentos (Extract Text from Image usa OCR no dispositivo)
Resize Image / Crop Image / Convert Image / Flip Image / Mask Image / Overlay Image / Remove Image Background / Combine Images Forma um pipeline de imagens
Make GIF / Add Frame to GIF / Make Video from GIF / Encode Media / Trim Media Converte mídia
Make Spoken Audio from Text / Record Audio / Dictate Text Processa entrada e saída de áudio

Calendar, Reminders, Contacts e 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 e suas respectivas actions Get Details of… abrangem os apps de produtividade.16 A combinação Find/Filter + Get Details é o padrão: consulte uma coleção e depois extraia os campos dos resultados encontrados.

Shortcuts, metadados e fluxo

Action O que faz
Run Shortcut Chama outro shortcut com uma entrada
Get My Shortcuts / Get Details of Shortcut Inspeciona a biblioteca
If / Repeat / Repeat with Each / Choose from Menu Controla o fluxo
Set Variable / Get Variable / Add to Variable Gerencia estado explícito
Wait to Return / Stop This Shortcut / Stop and Output / Nothing Controla o tempo e o encerramento
Show Content / Get What’s On Screen Exibe conteúdo e obtém contexto
Open X-Callback URL / Open URLs Encaminha URLs

Uma observação sobre meta-automações para a Parte 6: Get My Shortcuts e Get Details of Shortcut permitem que um shortcut enumere a biblioteca, o que pode ser combinado com shortcuts list no lado do CLI para criar ferramentas em torno da sua coleção.162


Ações de scripts

Cinco ações conectam o Shortcuts à pilha tradicional de automação, e todas ficam atrás de um único controle global. Em Shortcuts → Settings → Advanced, “Allow Running Scripts” precisa estar ativado antes que qualquer uma delas seja executada; a própria descrição do app informa exatamente quais ações ela controla: “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 no macOS 26.5).817 A documentação da Apple acrescenta o aviso de que executar shortcuts com scripts pode causar perda de dados — essa configuração existe porque essas cinco ações são executadas com todos os privilégios do seu usuário, fora das proteções que limitam as ações comuns.8

Run Shell Script

O carro-chefe. Você escolhe o shell, cola o script e define como a entrada chega. Os dois modos de entrada vêm diretamente da própria documentação da ação: “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

Implicações práticas desses dois modos:

  • O modo stdin é adequado para texto e arquivos únicos: processamento no estilo pbpaste, JSON por meio do jq, qualquer coisa que leia um fluxo.
  • O modo arguments é adequado para vários arquivos: cada item de entrada chega em "$@", então for f in "$@"; do ... done lida corretamente com uma seleção do Finder, incluindo espaços.
  • A saída é tudo o que o script escreve em stdout e flui para a próxima ação como qualquer outra saída.

Run AppleScript e Run JavaScript for Mac Automation

Ambas incorporam scripts da Open Scripting Architecture com um ponto de entrada on run {input, parameters} (AppleScript) ou uma função run(input, parameters) (JXA). Use-as quando o trabalho for controlar outro app: organização de janelas do Finder, regras do Mail, qualquer coisa com um dicionário de scripts. O valor de retorno se torna a saída da ação.

Run Script Over SSH

Executa um shell script em um host remoto com host, porta, usuário e autenticação configurados na ação. O uso mais interessante é simétrico ao CLI: um Mac no seu escritório pode expor operações repetíveis para qualquer máquina que consiga acessá-lo por SSH, e um shortcut pode enviar trabalho para máquinas Linux sem sair do editor do Shortcuts.

Run JavaScript on Web Page

Executa JavaScript na página atual do Safari e retorna o resultado. A Apple a protege tanto pelo controle de scripts quanto por uma solicitação de permissão a cada execução, porque um JavaScript arbitrário no contexto da página é uma superfície para exfiltração de dados.8


Ações de gerenciamento de janelas

O Shortcuts inclui controle nativo de janelas no Mac: Find Windows, Move Window e Resize Window.16 Elas parecem entradas menores do catálogo, mas acabam sendo os blocos de construção para layouts de janela controlados pelo teclado, sem ferramentas de terceiros.

  • Find Windows consulta janelas abertas (classificáveis e filtráveis no editor) e produz objetos de janela.
  • Move Window recebe uma janela e uma posição. O resumo de parâmetros diz “Move ⟨Window⟩ to ⟨Position⟩,” com uma variante personalizada opcional, “Move ⟨Window⟩ to ⟨Position⟩ ⟨X Coordinate⟩, ⟨Y Coordinate⟩” (verificado no macOS 26.5).16
  • Resize Window recebe uma janela e um destino: “Resize ⟨Window⟩ to ⟨Configuration⟩,” com uma variante personalizada que aceita ⟨Width⟩ × ⟨Height⟩ explícitos.16

As posições de janela integradas na tabela de strings do framework são: Full Screen, Left, Right, Top, Bottom, terços (Left Third, Middle Third, Right Third), variantes de canto (Top/Bottom Leading e Trailing) e um formato personalizado de Window Location and Size (verificado no macOS 26.5).16 Combine Find Windows (janela em primeiro plano) → Resize Window (Left) com um atalho de teclado e você terá um comando de janela com uma tecla. Split Screen Apps lida com o caso de dois apps em uma única ação.16


A ação Use Model

Nova no macOS Tahoe e a ação individual mais importante que a Apple adicionou desde a chegada ao Mac: Use Model envia dados a um modelo do Apple Intelligence no meio de um shortcut e passa a resposta para a próxima ação.34

Três opções de modelo, segundo a sessão da WWDC da Apple sobre o recurso: um grande modelo baseado em servidor no Private Cloud Compute, o modelo no dispositivo “for simple requests without network connection,” e o ChatGPT “for broad world knowledge.”4

Três formatos de saída — e escolhê-los deliberadamente é a habilidade:4

  1. Texto (incluindo rich text) para resumos e reescritas.
  2. Dicionário para extração estruturada; o exemplo da Apple extrai fornecedor, valor e data de faturas. A saída em dicionário é o que torna Use Model combinável: as ações subsequentes leem campos em vez de analisar prosa.
  3. Entidades de apps: objetos de conteúdo de apps que os expõem por meio de App Intents. A Apple descreve a relação assim: “If App Intents are the actions or verbs from your app, App Entities are the nouns,”4 e Use Model pode raciocinar diretamente sobre esses substantivos (filtrar estas notas, escolher o evento de calendário relevante).

Uma opção Follow Up permite iterar sobre a resposta do modelo dentro da mesma execução.4

Um cuidado de engenharia: a saída do modelo é não determinística, então a mesma entrada pode produzir resultados diferentes de uma execução para outra. Para automações, isso favorece o formato de saída em dicionário (restrito por esquema), prompts pequenos e focados e uma etapa de validação (uma ação If que verifica os campos obrigatórios) antes que o resultado afete arquivos ou mensagens. Trate Use Model como uma chamada de rede instável: útil, envolvida em verificações.

Para a visão de desenvolvedor do mesmo recurso (o que seu app deve expor para que Use Model possa raciocinar sobre ele), consulte a Parte 6 e o conjunto de App Intents neste site, começando com App Intents Are Apple’s New API to Your App.


Gatilhos de automação no macOS

Automações são shortcuts com um gatilho associado: “execute isto quando aquilo acontecer”, sem necessidade de clicar. Elas chegaram ao Mac no macOS Tahoe, e a Apple criou gatilhos específicos para Mac em vez de simplesmente trazer toda a lista do 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

Crie-as na área Automation do app Shortcuts. Cada automação combina um gatilho com um conjunto de ações e uma decisão de política: Run Immediately (sem interação, que é o objetivo da automação) ou Run After Confirmation (uma notificação pergunta primeiro).318 Comece novas automações com confirmação até confiar nelas; depois, mude para execução imediata.

O catálogo de gatilhos no macOS Tahoe:3418

Gatilho É acionado quando Observações
Time of Day Um horário chega (específico, nascer do sol, pôr do sol) Opções de repetição diária/semanal/mensal
Alarm Um alarme do app Clock dispara, é adiado ou para
Email Um email chega de remetentes escolhidos ou que atende a critérios
Message Uma mensagem chega de pessoas escolhidas ou contendo texto
Folder O conteúdo de uma pasta monitorada muda O destaque do Mac; veja os padrões abaixo
File Um arquivo monitorado é modificado Diferente de Folder — o exemplo da Apple é “When my file is modified”3
External Drive Uma unidade é conectada ou desconectada Fluxos de trabalho de backup e ingestão
Display Um monitor é conectado ou desconectado Layouts para acoplamento à mesa
Wi-Fi Ao entrar ou sair de uma rede Contexto semelhante a localização em um sistema operacional de desktop
Bluetooth Um dispositivo é conectado ou desconectado Fones de ouvido, dispositivos de entrada
Battery Level O nível atinge, sobe acima ou cai abaixo de um limite Relevante para laptops
Charger A alimentação é conectada ou desconectada Relevante para laptops
App Um app é aberto ou encerrado Combine com Split Screen Apps ou ações de janela
Focus Um modo Focus é ativado ou desativado
Stage Manager Stage Manager é alternado

Duas mudanças decorrem desse design. Primeiro, o Mac finalmente tem uma resposta nativa da Apple para “monitorar esta pasta e processar o que chegar nela”, que sincroniza e é editada como qualquer outro shortcut (as Folder Actions do Automator faziam o monitoramento, mas não o restante). Segundo, como as automações executam shortcuts, tudo neste guia se combina: um gatilho Folder pode alimentar Run Shell Script; um gatilho App pode chamar Use Model; um gatilho External Drive pode iniciar um trabalho de SSH.

Padrões de automação que funcionam

Padrões confiáveis no uso diário, montados inteiramente com componentes documentados:

A pasta monitorada. Gatilho de pasta em ~/Inbox → Filter Files (a extensão é pdf) → Extract Text from Image ou Get Text from PDF → Use Model com saída em formato de dicionário (fornecedor, data, total) → Rename File e Move File para uma hierarquia de arquivamento. O caso de uso clássico do Automator, aprimorado com extração no dispositivo e nomenclatura estruturada pelo modelo.3416

A estação de trabalho. Gatilho de tela (uma tela externa é conectada) → Open App para seu conjunto de trabalho → Move Window e Resize Window para organizar seu layout → Set Focus como Work. Inverta o processo ao desconectar. Um único gatilho recria todo o layout da estação de trabalho sem precisar arrastar janelas manualmente.316

A unidade de importação. Gatilho de unidade externa → Get Contents of Folder na pasta DCIM do cartão → Filter Files por data → Save File em uma pasta com a data → Show Notification com a quantidade. Nesse caso, é prudente usar o modo de confirmação: unidades inesperadas não devem acionar cópias em massa.318

A saída para código de verdade. Qualquer gatilho → Run Shell Script com a entrada como argumentos → seu script existente. O sistema de gatilhos é a parte valiosa; nada exige que a lógica fique nas actions do Shortcuts. Uma automação de duas actions (gatilho + script) oferece tratamento de eventos no estilo launchd, com interface, sincronização e gerenciamento de consentimento sem custo adicional.817

Contextos relacionados a reuniões. Gatilho de Focus (Work Focus ativado)18 → Set Volume, Quit App para apps que causam distração, Open App para anotações. Com o compartilhamento do Focus entre dispositivos ativado nos System Settings, o Mac reage a um Focus ativado no iPhone.

Restrições que devem orientar o projeto: uma automação existe no Mac em que você a cria, portanto, uma automação de pasta criada no MacBook não será acionada no Mac mini, embora a biblioteca de atalhos seja sincronizada (configure o gatilho em cada máquina que precisar dele), e a lista de gatilhos não tem uma opção “solicitação web recebida” (contorne isso com Run Script Over SSH no lado do remetente ou com uma pasta monitorada por um cliente de sincronização em nuvem).318


O CLI do shortcuts

Desde o Monterey, o macOS inclui uma verdadeira interface de linha de comando para o Shortcuts: /usr/bin/shortcuts, documentada em shortcuts(1) e no guia do usuário da Apple.12 Ela tem quatro subcomandos. Verifiquei tudo abaixo no 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

Executa um atalho pelo nome ou identificador. “Executar atalhos pela linha de comando não é diferente de executá-los no app Shortcuts”,1 o que tem dois lados: acesso completo às actions e todas as solicitações de permissão (consulte Permissões).

Flag Significado
-i, --input-path Entrada para o atalho. Pode ser repetida; aceita caminhos, globs ou - para stdin2
-o, --output-path Onde gravar a saída; - para stdout2
--output-type Formato de saída como um Uniform Type Identifier, por exemplo, public.plain-text ou com.apple.rtfd; quando omitido, é inferido pelo nome do arquivo de saída2

O exemplo oficial da Apple executa um atalho de combinação de imagens em uma pasta de arquivos JPEG:1

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

O CLI respeita o contrato Unix nas duas pontas. Status de saída: “O comando shortcuts encerra com 0 após uma execução bem-sucedida ou com 1 em caso de erro.”1 O encadeamento da saída funciona quando o atalho termina com uma saída ou contém Stop and Output: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 -

Uma armadilha documentada: enviar texto para shortcuts run por pipe faz com que ele seja recebido como texto. “Quando você passa o caminho de um arquivo usando um pipe, o caminho é tratado como texto. Use a flag -i para garantir que a entrada seja tratada como caminhos de arquivos.”1

E vale gravar uma regra de projeto da Apple: “os atalhos mais eficientes são aqueles que não exibem alertas nem solicitam entradas. Quando um atalho solicita uma entrada, o processo da linha de comando é pausado enquanto aguarda a entrada do usuário.”1 Em qualquer execução headless, essa pausa equivale a um travamento. Crie atalhos voltados ao CLI para receber todos os parâmetros pela entrada.

shortcuts list

Lista os nomes dos atalhos, um por linha. --folders lista as pastas; -f <folder> limita a uma pasta (“none” para atalhos que não estão em nenhuma pasta); --show-identifiers acrescenta o UUID de cada atalho.2 Os identificadores são importantes para a automação: nomes podem coincidir e ser alterados, mas UUIDs não. shortcuts run aceita ambos.2

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

shortcuts view

Abre o atalho indicado no editor do Shortcuts.2 É útil no fim de uma cadeia de ferramentas: um script que detecta um atalho com falha pode abrir diretamente o editor correspondente.

shortcuts sign

Assina um arquivo .shortcut para distribuição; esse assunto é abordado com os formatos de compartilhamento na Parte 5.2


Como controlar o app por script com Shortcuts Events

A terceira interface programática é a interface de scripting. No Mac, o Shortcuts registra dois alvos compatíveis com scripts: o próprio app Shortcuts e um auxiliar em segundo plano sem interface, o Shortcuts Events (identificador do bundle com.apple.shortcuts.events, verificado no macOS 26.5).11 O dicionário de scripting explica o motivo dessa divisão: “Para executar um atalho em segundo plano sem abrir o app Shortcuts, envie o comando para ‘Shortcuts Events’ em vez de ‘Shortcuts’.”11

O dicionário é pequeno e estável. Os atalhos têm as propriedades legíveis name, subtitle, id, folder, color, icon, accepts input e action count; as pastas têm name e id; e o único verbo é run, com um parâmetro opcional with input e um 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 por meio de ScriptingBridge ou py-applescript usa a mesma interface; com o ScriptingBridge do PyObjC, SBApplication.applicationWithBundleIdentifier_("com.apple.shortcuts.events") retorna o objeto do app, cuja coleção shortcuts() corresponde ao dicionário acima.11

Quando preferir essa opção ao CLI: quando você já está em um contexto AppleScript/JXA, quer o resultado do atalho como um objeto nativo em vez de stdout serializado ou inicia execuções por um app que pode enviar Apple Events, mas não deve executar comandos no shell. O primeiro Apple Event enviado por um processo host ao Shortcuts Events aciona a solicitação de consentimento padrão de Automation do macOS (System Settings → Privacy & Security → Automation), mais uma solicitação que precisa ser autorizada antes da operação sem supervisão.6

O dicionário também oferece acesso no nível de organização (as pastas e os metadados dos atalhos podem ser lidos, e a atribuição de pastas pode ser alterada), portanto, a manutenção da biblioteca (relatórios de inventário e auditorias de pastas) pode ser automatizada por scripts sem interagir com a interface.11


URL schemes

O Shortcuts registra o URL scheme shortcuts:// (além do antigo workflow://, herdado das origens do app antes da aquisição, verificado no macOS 26.5).19 URLs são o caminho de integração para outros apps: launchers, apps de anotações com campos de link e qualquer ferramenta capaz de abrir uma URL. A orientação da Apple é direta: “Você só deve executar atalhos com uma URL ao integrar outro app externo ao Shortcuts.”9

Executar um atalho:9

shortcuts://run-shortcut?name=[name]&input=[input]&text=[text]
  • name (obrigatório): nome do atalho codificado em percent-encoding.
  • input: text ou clipboard. Com text, o valor do parâmetro text se torna a entrada do atalho; com clipboard, “o conteúdo da área de transferência é usado” e text é ignorado.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 adiciona o tratamento de respostas para operações de ida e volta:20

shortcuts://x-callback-url/run-shortcut?name=Calculate%20Tip&input=text&text=24.99&x-success=...&x-error=...&x-cancel=...
  • x-success é aberto em caso de sucesso, com a saída de texto do atalho acrescentada como um parâmetro result.
  • x-error é aberto em caso de falha, com um parâmetro errorMessage.
  • x-cancel é aberto se o usuário cancelar e não fornece nenhuma saída.20

No shell, open "shortcuts://run-shortcut?..." funciona, mas prefira shortcuts run: nesse contexto, o CLI retorna códigos de saída e a saída diretamente, sem precisar passar por callbacks de URL. No Mac, o nicho restante desse scheme é a integração entre apps e os links dentro de documentos.


Formatos de compartilhamento e assinatura

Os Shortcuts podem ser distribuídos de duas maneiras, e ambas terminam em uma decisão de confiança.7

Links do iCloud. No app: compartilhar → Copy iCloud Link. Qualquer pessoa com o link pode adicionar o shortcut à própria biblioteca, o que torna os links a opção mais simples para publicar para o mundo. Considere o link público assim que ele for enviado.7

Arquivos de shortcut. File → Export gera um arquivo .shortcut (UTI com.apple.shortcut, verificado no macOS 26.5).197 A exportação exige que você escolha uma opção de confiança:

  • Anyone: “Qualquer pessoa pode executar seu shortcut.” A Apple recebe uma cópia do shortcut para validação.7
  • People Who Know Me: “Somente pessoas que têm você nos contatos poderão executar seu shortcut.” Suas informações de contato são incorporadas ao arquivo para essa verificação.7

O CLI oferece os mesmos dois modos e identifica o mecanismo, de acordo com shortcuts(1) no macOS 26.5: people-who-know-me “assina localmente, mas somente seus dispositivos ou pessoas que tenham suas informações salvas nos contatos poderão importar o shortcut”, enquanto anyone “faz a notarização via iCloud e permite que qualquer pessoa importe o shortcut”.2

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

Esse comando é a solução de distribuição para equipes e CI: shortcuts exportados e assinados com -m anyone são importados sem problemas por destinatários que nunca tiveram contato com você. Como o modo anyone faz a notarização pelo iCloud, garanta uma sessão conectada ao iCloud e acesso à rede antes de integrá-lo a um pipeline de build.2

A importação funciona por arrastar e soltar: clique duas vezes em um arquivo .shortcut, arraste-o para o app ou solte-o sobre o ícone no Dock; arquivos .workflow são convertidos do Automator durante a importação.15 Shortcuts compartilhados fora da Gallery vêm com uma ressalva que a Apple declara claramente: “A Apple não pode verificar a autenticidade nem o comportamento de shortcuts compartilhados de forma privada.”6 Frotas corporativas têm uma opção específica: o Apple Configurator oferece suporte a automações do Shortcuts em workflows gerenciados.21

Settings → Advanced também contém Private Sharing, a opção que controla a importação de shortcuts compartilhados de forma privada (restritos a contatos), junto de Allow Running Scripts e Allow Sharing Large Amounts of Data.68 Quando um shortcut recebido não pode ser importado, a causa geralmente é uma destas: arquivo sem assinatura, arquivo restrito a contatos enviado por alguém que não está nos seus contatos ou Private Sharing desativado.


App Intents: como os apps adicionam actions

Até agora, tudo no catálogo é da Apple. A outra metade da biblioteca vem dos apps instalados e, desde 2022, há um único framework responsável por esse processo: App Intents (iOS 16, macOS 13).13 Um app define tipos em conformidade com AppIntent (um verbo: parâmetros mais um método perform()), opcionalmente com AppEntity (um substantivo: uma parte tipada do conteúdo do app, com identificador e representação visual), e o sistema cuida do restante. As mesmas definições aparecem no Shortcuts, Siri, Spotlight, widgets e Apple Intelligence; o Shortcuts é uma projeção do esquema de intents do app, não uma integração separada.134

Dois níveis de adoção determinam como um app aparece no Mac:

  • Actions: todo intent que não estiver oculto aparece como uma action no editor do Shortcuts, sob o nome do app, e pode ser combinado com tudo o que é abordado neste guia.
  • App Shortcuts: intents encapsulados em um AppShortcutsProvider são fornecidos como shortcuts prontos para execução assim que o app é instalado, sem exigir que o usuário os monte e com frases de ativação da Siri vinculadas.13

O alcance do framework continua crescendo a cada ciclo anual. A sessão da WWDC25 sobre Shortcuts e Spotlight apresenta diretamente o contrato atual para o Mac: “Desde que seu intent esteja disponível no macOS, ele também estará disponível no Shortcuts para ser executado como parte das automações no Mac. Isso inclui apps para iOS que podem ser instalados no macOS.”4 Um app para iPhone executado em um Mac com Apple silicon adiciona actions às automações do Mac sem uma única linha de código específica para o Mac.

Em resumo, as orientações de adoção da Apple apresentadas na mesma sessão são: exponha seu conteúdo como entidades com “propriedades importantes sobre as quais você gostaria que um modelo pudesse raciocinar” (a action Use Model as utiliza), forneça actions de busca para que as consultas funcionem, use strings com atributos quando um texto rico fizer sentido e mantenha os resumos dos parâmetros legíveis.4

Orientações de design para autores de intents, extraídas da implementação de App Intents em apps em produção:

  • Intents são API. Trate nomes, parâmetros e identificadores de entidades como um contrato; renomeá-los quebra os shortcuts dos usuários da mesma forma que renomear um endpoint quebra os clientes.
  • A execução em segundo plano é melhor do que em primeiro plano. Um intent que pode ser executado sem abrir o app pode ser combinado em automações; um que exige trazer o app para o primeiro plano interrompe o que o usuário estava fazendo. Separe os dois casos de forma intencional.4
  • Os valores retornados alimentam pipelines. Um intent que retorna uma entidade ou um valor oferece aos usuários do Shortcuts algo para encadear; um que não retorna nada é um beco sem saída no grafo.

Este site aborda detalhadamente o lado do desenvolvedor no conjunto sobre App Intents: App Intents são a nova API da Apple para o seu app (os argumentos para adoção e um passo a passo em produção), App Intents 2.0 no iOS 26 (Visual Intelligence, snippets e propriedades adiadas), App Intents no iOS 27 (intents de longa duração em segundo plano, entidades sincronizáveis e reindexação do Spotlight) e App Intents vs. MCP (quando o mesmo recurso também deve ser uma ferramenta para agentes).


Spotlight e automações executam seus intents

O macOS Tahoe ampliou os locais em que intents são executados, e as duas novidades mudam os benefícios de “adotar App Intents” no Mac.4

O Spotlight executa intents diretamente. “A partir deste ano, você pode executar actions do seu app diretamente pelo Spotlight no Mac. Seus apps podem exibir actions no Spotlight adotando App Intents, da mesma forma que você faz para o Shortcuts.”4 Os requisitos são específicos o bastante para serem auditados:

  1. O resumo dos parâmetros (“uma representação curta, em linguagem natural, do que o intent do app faz”) “deve conter todos os parâmetros obrigatórios que não tenham um valor padrão”.4
  2. O intent não pode desativar a descoberta: isDiscoverable como false ou assistantOnly como true o remove do Spotlight.4
  3. As sugestões e a busca vêm da camada de entidades: implemente entidades sugeridas ou uma consulta de entidades enumerável para o seletor, além de uma consulta de entidades por string ou entidades indexadas para a busca enquanto o usuário digita.4

As automações executam intents sem supervisão. Como as automações do Tahoe executam shortcuts, e shortcuts executam intents, uma alteração em uma pasta ou a montagem de uma unidade agora pode acionar o intent de um app sem que um usuário esteja presente.4 Para autores de intents, isso eleva o padrão estabelecido na seção anterior: um intent que pressupõe um usuário em primeiro plano (exibe uma interface ou exige confirmação) falha silenciosamente dentro de uma automação Run Immediately. Avalie cada intent para execução sem supervisão: o que acontece quando ninguém está olhando para a tela?

Juntos, os dois formam a sutil declaração arquitetural da Apple: o intent, e não a janela do app, é a unidade de funcionalidade no Mac. O Spotlight é quem faz as chamadas interativas, as automações fazem as chamadas sem supervisão e o Shortcuts é a camada de composição entre eles.


Acionando Shortcuts por meio de scripts e agentes

Shortcuts ocupa um nicho específico nas arquiteturas de agentes e scripts: é a forma com menos privilégios e mais fácil de auditar pelo usuário para que código externo acione recursos do Mac. Um agente de IA com acesso ao shell pode fazer a maioria das coisas diretamente, mas encaminhar uma operação por um atalho oferece propriedades que o shell puro não tem: a operação é definida e editável pelo usuário, suas permissões são concedidas por atalho e podem ser revogadas com um clique, e seu raio de impacto fica visível no editor.6 Pense na camada de atalhos como um catálogo de recursos que a pessoa organiza e o agente aciona.

Há um requisito indispensável para que tudo isso funcione: o CLI precisa de uma sessão gráfica com login ativo. Todo subcomando de shortcuts — inclusive list — se comunica com um aplicativo auxiliar na sessão Aqua do usuário e falha com “Couldn’t communicate with a helper application” quando não há nenhuma sessão disponível (verificado no macOS 26.5). Sessões somente por SSH, executores de CI sem interface gráfica e daemons de inicialização esbarram nessa limitação; execute agentes e chamadas agendadas dentro de uma sessão de usuário com login ativo — um agent do launchd, não um daemon.

O contrato de chamada, em termos de agentes:12

Propriedade Valor
Descobrir shortcuts list --show-identifiers
Executar shortcuts run <name-or-uuid> (prefira UUIDs; nomes podem mudar)
Entrada -i com caminhos de arquivos ou - para stdin
Saída -o - para stdout, --output-type <UTI> para forçar o formato
Sinal de sucesso Código de saída 0/11
Modos de falha Saída diferente de zero; ou espera indefinida em um prompt interativo

Dados estruturados atravessam essa fronteira como texto. O padrão viável é usar JSON por stdin/stdout: o chamador envia um documento JSON (-i -), o atalho o analisa com Get Dictionary from Input (Obter dicionário da entrada), realiza o trabalho e termina com Stop and Output (Parar e gerar saída), devolvendo um dicionário como texto.116 O atalho se torna uma função tipada com um esquema documentado; mantenha um README com o formato esperado de entrada e saída de cada atalho junto à configuração do agente que o aciona.

Os timeouts são responsabilidade do chamador. Como um atalho que exibe um alerta pausa o processo CLI indefinidamente,1 todo chamador não supervisionado deve aplicar um timeout à execução e tratar o vencimento como falha:

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

Prepare as permissões antes da execução não supervisionada. Execute cada atalho interativamente uma vez e responda Always Allow (Sempre permitir) aos prompts; confirme em um terminal que a execução não exibe prompts antes de permitir que um agente ou tarefa do launchd o acione.61 A seção sobre permissões explica o que você está autorizando antecipadamente.

Escolha o ponto de entrada de acordo com o tipo de chamador. Chamadores com acesso ao shell (agentes, CI, agents do launchd, Makefiles — todos dentro de uma sessão com login ativo) usam o CLI. Contextos de Apple Event (aplicativos AppleScript, daemons PyObjC) usam Shortcuts Events e recebem valores de retorno nativos.11 Contextos em sandbox ou limitados a URLs usam shortcuts://run-shortcut com x-callback para obter os resultados.920 As três opções executam o mesmo atalho; apenas o meio de transporte muda.

A direção inversa também funciona: atalhos como frontends de agentes. Um atalho associado a um atalho de teclado ou à barra de menus pode coletar o contexto (seleção, área de transferência, aplicativo em primeiro plano), enviá-lo para Run Shell Script (Executar script do shell) para acionar o CLI do seu agente e exibir o resultado — as superfícies de entrada do sistema operacional se tornam a interface das ferramentas subjacentes.1017


Permissões e consentimento (TCC)

Shortcuts herda o modelo de segurança do macOS baseado em consentimento, e toda falha de automação que não seja um erro de lógica acaba levando a essa área. O modelo tem quatro camadas; identifique qual delas está exibindo o prompt para tornar as correções simples e sistemáticas.

1. Consentimento de dados por atalho. Na primeira vez que um atalho acessa um recurso protegido, Shortcuts pergunta: “If a Privacy dialog appears requesting access to data, choose Allow Once, Always Allow, or Don’t Allow.” Always Allow significa que “the Shortcuts app won’t ask you for access the next time you run the shortcut.”6 As autorizações são concedidas por atalho e por recurso e podem ser inspecionadas: o painel de detalhes de cada atalho tem uma aba Privacy (Privacidade), na qual você pode revogar autorizações individuais; para remover o acesso do atalho a todos os dados, clique em Reset Privacy (Redefinir privacidade).6

2. A barreira para scripts. As cinco ações de script só são executadas quando Settings → Advanced → Allow Running Scripts (Configurações → Avançado → Permitir execução de scripts) está ativado (lista completa acima).8 A configuração é global, não específica de cada atalho; ativá-la para um script de pasta monitorada também a ativa para todos os atalhos importados, o que reforça a importância de ler os atalhos importados antes de executá-los.6

3. Prompts do TCC do sistema. Ações que acessam áreas protegidas do sistema operacional (Files and Folders, Automation/Apple Events para controlar outros aplicativos por scripts e Accessibility para controlar entradas) acionam os diálogos do sistema gerenciados em System Settings → Privacy & Security (Ajustes do Sistema → Privacidade e Segurança). Essas permissões ficam associadas ao processo responsável, por isso um atalho pode se comportar de maneiras diferentes no aplicativo, por meio do CLI e em uma automação: são contextos de inicialização diferentes, com autorizações independentes.6

4. Política de execução da automação. A configuração Run Immediately (Executar imediatamente) ou Run After Confirmation (Executar após confirmação) de cada automação determina se o próprio gatilho exige intervenção humana.18

Regras operacionais decorrentes:

  • Os prompts não aparecem onde ninguém está olhando. Contextos sem interface gráfica (sessões por SSH, executores de CI, agentes) estão sujeitos à primeira regra da seção sobre o CLI: um diálogo de consentimento sem resposta causa uma pausa indefinida.1 Conceda as autorizações antecipadamente de forma interativa.
  • Reset Privacy é a ferramenta de depuração para recomeçar do zero. Quando um atalho apresenta problemas após alterações, redefinir suas autorizações e executá-lo novamente de forma interativa faz com que todos os prompts reapareçam na ordem.6
  • Vale a pena ler os atalhos importados. A Apple valida atalhos assinados para “Anyone”, mas “cannot verify the authenticity or behavior of shortcuts shared privately.”67 A aba Privacy mostra quais permissões foram concedidas a um atalho; o editor mostra o que ele faz. Verificar ambos leva apenas um minuto.

Solução de problemas

Sintoma Causa provável Correção
shortcuts run fica travado indefinidamente O atalho exibe um alerta ou solicita uma entrada; o CLI fica pausado aguardando o usuário1 Reformule-o para receber parâmetros pela entrada; aplique um timeout aos chamadores (gtimeout do coreutils — o macOS não tem um timeout integrado)
Atalho não encontrado pelo CLI Nome divergente ou alterado shortcuts list --show-identifiers; execute pelo UUID2
Funciona no aplicativo, mas falha pelo CLI ou pela automação O consentimento foi concedido para um contexto de inicialização, mas não para outro6 Execute uma vez de forma interativa no contexto que apresenta a falha; responda Always Allow
A ação de script não faz nada Allow Running Scripts está desativado8 Settings → Advanced → Allow Running Scripts
A execução por AppleScript/ScriptingBridge falha O aplicativo host não tem permissão de Automation para Shortcuts Events6 System Settings → Privacy & Security → Automation
O arquivo .shortcut importado não abre Não está assinado, está restrito a contatos ou Private Sharing está desativado26 Peça ao remetente que assine com -m anyone; verifique Settings → Advanced → Private Sharing
shortcuts sign -m anyone falha A notarização exige o iCloud2 Inicie uma sessão no iCloud e tente novamente
A automação de pasta não é acionada As automações são locais ao dispositivo; está no Mac errado ou o gatilho exige confirmação Recrie-a no Mac de destino; verifique Run Immediately318
O caminho de arquivo enviado por pipe chega como texto Pipes transmitem texto, não arquivos1 Use -i para entradas de arquivo
O arquivo de saída está no formato errado O tipo foi inferido pelo nome do arquivo Defina --output-type com um UTI explícito12
A automação foi executada, mas nada visível aconteceu Ela foi executada sem interface gráfica, conforme planejado Adicione Show Notification (Mostrar notificação) como última ação durante a depuração
As ações de janela afetam a janela errada Find Windows retornou várias correspondências Filtre ou ordene em Find Windows; selecione explicitamente o primeiro item16

Cartão de referência 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

Checklists. Atalho pronto para execução não supervisionada: sem alertas nem parâmetros Ask Each Time; consentimento concedido antecipadamente com Always Allow; execução pelo UUID; o chamador aplica um timeout; termina com Stop and Output.16 Arquivo pronto para distribuição: exportado, assinado com -m anyone, contrato de entrada documentado.27


Perguntas frequentes

Como executo um atalho do Mac pelo Terminal? shortcuts run "Shortcut Name", opcionalmente com -i para arquivos de entrada (ou - para stdin), -o para saída (ou - para stdout) e --output-type com um Uniform Type Identifier. O comando retorna 0 em caso de sucesso e 1 em caso de erro, portanto funciona com &&, if e make como qualquer ferramenta Unix.12

O macOS finalmente tem automações do Shortcuts como o iOS? Sim, desde o macOS Tahoe (26). Os gatilhos incluem Horário do Dia, Alarme, E-mail, Mensagem, alterações em Pasta, alterações em Arquivo, Unidade Externa, Tela, Wi-Fi, Bluetooth, Nível da Bateria, Carregador, abertura/fechamento de app, Foco e Stage Manager, cada um configurável para executar imediatamente ou após confirmação.3418

O que shortcuts sign -m anyone realmente faz? Ele autentica o arquivo do atalho pelo iCloud para que qualquer pessoa possa importá-lo. O modo padrão, people-who-know-me, assina localmente e restringe a importação aos seus próprios dispositivos e às pessoas que têm suas informações de contato no Contacts.2

Como os apps adicionam suas próprias actions ao Shortcuts no Mac? Adotando o framework App Intents. Os intents aparecem automaticamente como actions do Shortcuts, e um AppShortcutsProvider fornece App Shortcuts sem configuração junto com o app. Os intents disponíveis no macOS também são executados pelo Spotlight e nas automações do Tahoe, inclusive os intents de apps iOS instalados em Macs com Apple silicon.134

Como um script ou agente de IA deve invocar atalhos? Use o CLI: descubra com shortcuts list --show-identifiers, invoque pelo UUID, passe JSON pelo stdin, leia os resultados pelo stdout e envolva cada chamada em um timeout, pois um atalho que exibe uma solicitação ficará pausado para sempre (o macOS não inclui timeout(1) — use gtimeout do coreutils ou o timeout de processo da sua linguagem). Autorize previamente, de modo interativo, as solicitações de permissão de cada atalho antes do uso não supervisionado. Em contextos de AppleScript, direcione para Shortcuts Events para executar sem abrir o app.1211

Shortcuts pode substituir o Automator? Para a maioria dos fluxos de trabalho, sim; a Apple chama o Shortcuts de futuro da automação no Mac e criou um conversor que importa diretamente a maioria dos arquivos .workflow. O Automator ainda acompanha o sistema e continua executando fluxos de trabalho existentes, então a migração é uma escolha, não um prazo.51415


Registro de alterações

Data Alteração Fonte
2026-08-16 Três correções em relação ao próprio artigo já citado da Apple, além de a observação sobre o macOS 27 passar a usar fontes primárias. A tabela de gatilhos de automação não incluía Arquivo (“Quando meu arquivo é modificado”), que o artigo de suporte 125148 lista separadamente de Pasta — um erro presente desde a v1.0 em relação a uma fonte que o guia já cita. Adicionado Control Center à tabela de pontos de entrada (“Run Shortcut, Open App, and Show ‘Menu Bar’ Collection”) e registrado que atalhos executados pelo Spotlight agora podem aceitar entrada, como texto selecionado em um documento aberto. O macOS 27 beta 5 (2026-08-10) agora inclui uma seção real sobre Shortcuts nas notas de versão da Apple, substituindo a observação prospectiva anterior deste guia, baseada em fontes secundárias: uma correção para a action Use Model que falhava na opção On-Device (181071784) e dois problemas conhecidos — editar um atalho criado por intent com “Describe a change” pode falhar quando o intent usa Duration ou LPLinkMetadata (166068090), e as automações de Nível da Bateria e Carregador podem não funcionar no macOS (180337087), o que quebra duas linhas da tabela de gatilhos no beta 27. A sessão 310 da WWDC26 documenta valores persistentes de Storage (sincronizados pelo iCloud e compartilhados entre atalhos), um inspetor de transcrição do Use Model e os tipos de automação Captura de Tela / Teclado / Notificação — a Apple não declara disponibilidade no macOS para esses três gatilhos, e as notas do macOS 27 não os listam; por isso, eles ficam fora da tabela de gatilhos do Mac até que surja uma fonte específica para Mac. A versão distribuída do macOS agora é a 26.6.2 (25G82); não existem notas de versão para desenvolvedores da 26.6.1/26.6.2, portanto não há alteração documentada do Shortcuts. Verificado como inalterado: o material sobre CLI, assinatura, Shortcuts Events, URL scheme e permissões. 322
2026-07-27 Verificação de atualidade, sem alterações no corpo. O macOS Tahoe 26.6 (25G72) foi lançado de forma estável em 27 de julho de 2026, encerrando o ciclo beta acompanhado pela linha anterior. As notas de versão da Apple para a 26.6 listam quatro itens — uma descontinuação do CoreStorage (HFS+ criptografado perde suporte no macOS 28), uma correção do Ecosystem para avisos de descontinuação que identificavam incorretamente um app host como exclusivo para Intel quando um plugin carregava código x86, uma correção de estatísticas do HealthKit e uma correção de captura de tela HDR no Messages — e não mencionam nenhuma alteração em Shortcuts, WorkflowKit ou App Intents, portanto todas as declarações deste guia sobre catálogo, CLI e automação seguem inalteradas. O corpo ainda diz “verificado no macOS 26.5” de propósito: foi nele que a tabela de strings do WorkflowKit e shortcuts(1) foram inspecionados diretamente, e a reinspeção na 26.6 ainda não aconteceu. O macOS 27 “Golden Gate” continua sendo a observação prospectiva. 23
2026-07-21 Verificação de atualidade, sem alterações no corpo. O macOS Tahoe distribuído continua com Shortcuts 7.0 (verificado na 26.5.2; as betas da 26.6 foram versões de manutenção sem alterações em Shortcuts ou App Intents). Observação prospectiva: a primeira beta pública do macOS 27 “Golden Gate” (13 de julho de 2026) apresenta o app Shortcuts de próxima geração — criação em linguagem natural com “Describe a Shortcut” por meio de Apple Intelligence, com o editor manual mantido e um padrão selecionável pelo usuário entre os dois — além de extensões do Safari criadas por IA a partir de descrições. Recursos beta podem mudar antes do lançamento previsto para setembro; a atualização do corpo será publicada quando o macOS 27 for lançado. Cobertura da beta pública por MacRumors/MacStories, 13 de julho de 2026
2026-07-07 Guia v1.0: lançamento inicial cobrindo o Shortcuts 7.0 no macOS 26 (Tahoe). Catálogo de actions verificado no WorkflowKit do macOS 26.5; CLI verificado em relação a shortcuts(1); automações, Use Model e execução pelo Spotlight conforme a documentação da Apple e a sessão 260 da WWDC25; dicionário do Shortcuts Events inspecionado por meio de sdef. 12341116

Referências


  1. Apple, “Run shortcuts from the command line”, Guia do Usuário do Shortcuts para Mac. Fonte primária para o comportamento de CLI: o exemplo Combine Images, o encadeamento stdin/stdout, a ressalva de que o pipe entrega texto, a tipagem de saída pelo Uniform Type Identifier, o status de saída (“O comando shortcuts sairá com 0 em uma execução bem-sucedida ou 1 em caso de erro”) e a orientação de que shortcuts que mostram alertas pausam o processo de linha de comando aguardando entrada. 

  2. Página de manual shortcuts(1) e saída de shortcuts help <subcommand>, verificadas no macOS 26.5 (Shortcuts 7.0). Fonte primária para os quatro subcomandos e todas as flags: run (--input-path com - para stdin, --output-path com - para stdout, --output-type no formato UTI), list (--folder-name, --folders, --show-identifiers), view e sign (valores de --mode anyone e people-who-know-me, sendo que anyone autentica via iCloud e people-who-know-me assina localmente com importação restrita a contatos). 

  3. Apple, “What’s new in Shortcuts for iOS, iPadOS, macOS, watchOS, and visionOS 26”, Apple Support. Fonte primária para a chegada das automações pessoais ao macOS no ciclo de lançamento do 26 e para a lista de eventos (horário do dia, email ou mensagem de pessoas específicas, alterações em pastas, conexão/desconexão de unidade externa, Wi-Fi, conexão de dispositivo Bluetooth, conexão/desconexão de tela, abertura ou encerramento de app). 

  4. Apple, “Develop for Shortcuts and Spotlight with App Intents” (sessão 260 da WWDC25). Fonte primária para a ação Use Model (opções de modelo Private Cloud Compute, no dispositivo e ChatGPT; tipos de saída de texto, dicionário e entidade de app; o toggle Follow Up), execução de app intents pelo Spotlight no Mac (requisitos de resumo de parâmetros, isDiscoverable/assistantOnly, orientação sobre consultas de entidades), automações no Mac (“automações de pasta e unidade externa criadas especificamente para o Mac”) e a declaração de que intents disponíveis no macOS são executadas em automações “incluindo apps iOS que podem ser instalados no macOS.” 

  5. Apple, “Meet Shortcuts for macOS” (sessão 10232 da WWDC21). Fonte primária para a introdução no Monterey: “Shortcuts é o futuro da automação no Mac”, a implementação em SwiftUI, a sincronização via iCloud das bibliotecas existentes, a ferramenta de migração do Automator (“pode converter a maioria dos workflows do Automator em Shortcuts”), qualquer app para Mac fornecendo actions e suporte a shell script + AppleScript no lançamento. 

  6. Apple, “Adjust privacy settings in Shortcuts on Mac”, Guia do Usuário do Shortcuts para Mac. Fonte primária para o fluxo de consentimento Allow Once / Always Allow / Don’t Allow, a aba Privacy por shortcut e Reset Privacy, o local das configurações Advanced (incluindo Allow Sharing Large Amounts of Data e Private Sharing) e o aviso de que “A Apple não pode verificar a autenticidade ou o comportamento de shortcuts compartilhados de forma privada.” 

  7. Apple, “Share shortcuts on Mac”, Guia do Usuário do Shortcuts para Mac. Fonte primária para compartilhamento por link do iCloud, File → Export e as opções de acesso: Anyone (“Qualquer pessoa pode executar seu shortcut”, com a Apple recebendo uma cópia para validação) e People Who Know Me (“Somente pessoas que têm você nos contatos poderão executar seu shortcut”, com informações de contato incluídas no arquivo). 

  8. Apple, “Advanced Shortcuts settings on Mac”, Guia do Usuário do Shortcuts para Mac, além da descrição da configuração no app, verificada no macOS 26.5: “Quando ativadas, as actions ‘Run AppleScript’, ‘Run Shell Script’, ‘Run JavaScript for Mac Automation’, ‘Run JavaScript on Web Page’ e ‘Run Script Over SSH’ podem ser executadas.” Fonte para a proteção Allow Running Scripts e seu aviso sobre perda de dados. 

  9. Apple, “Run a shortcut from a URL on Mac”, Guia do Usuário do Shortcuts para Mac. Fonte primária para a sintaxe shortcuts://run-shortcut, os parâmetros name, input (text ou clipboard) e text, ambos os exemplos documentados e a orientação de usar a action Run Shortcut em vez de URLs ao chamar shortcuts a partir de shortcuts. 

  10. Apple, “Run a shortcut while working on your Mac”, Guia do Usuário do Shortcuts para Mac. Fonte para Quick Actions (Use as Quick Action, Control-clique no Finder), a opção de menu Services, atalhos de teclado por shortcut via Add Keyboard Shortcut e execução pela barra de menus. 

  11. Dicionário de scripting do Shortcuts Events, inspecionado com sdef "/System/Library/CoreServices/Shortcuts Events.app" no macOS 26.5; identificador de bundle com.apple.shortcuts.events do Info.plist do app. Fonte primária para o comando run com with input e resultado, a observação sobre execução em segundo plano (“Para executar um shortcut em segundo plano, sem abrir o app Shortcuts, use ‘Shortcuts Events’ em vez de ‘Shortcuts’”), propriedades de shortcut (nome, subtítulo, id, pasta, cor, ícone, aceita entrada, contagem de actions), objetos de pasta e os grupos de acesso com.apple.shortcuts.run / com.apple.shortcuts.organize

  12. Apple, “Intro to Shortcuts on Mac”, Guia do Usuário do Shortcuts para Mac. Fonte para as definições de action/shortcut e o uso entre dispositivos de shortcuts criados em um Mac. 

  13. Apple, documentação do framework App Intents, Apple Developer. Fonte para o papel do framework (expor actions e conteúdo de apps ao Shortcuts, Siri, Spotlight, widgets e Apple Intelligence), os tipos AppIntent/AppEntity/AppShortcutsProvider e a disponibilidade nas plataformas desde iOS 16 e macOS 13. 

  14. Apple, “Import Automator workflows into the Shortcuts app on Mac”, Guia do Usuário do Automator. Fonte primária para arrastar para converter e “O Shortcuts pode converter a maioria dos workflows do Automator em shortcuts que executam as mesmas funções, eventos e automações.” 

  15. Apple, “Import shortcuts on Mac”, Guia do Usuário do Shortcuts para Mac. Fonte para a mecânica de importação de .shortcut (clique duplo, arrastar para o app ou Dock) e conversão de .workflow durante a importação, incluindo Open With → Shortcuts. 

  16. Tabela de strings em inglês do framework WorkflowKit (Localizable.loctable, /System/Library/PrivateFrameworks/WorkflowKit.framework), inspecionada no macOS 26.5 (Shortcuts 7.0). Fonte primária para os nomes literais de actions citados no catálogo (361 entradas distintas, incluindo Find Windows, Move Window, Resize Window, Split Screen Apps, Run Shortcut, Stop and Output, Get My Shortcuts, Use Model e Watch Me Do), os resumos de parâmetros de Move/Resize Window e posições de janela (Full Screen, Left, Right, terços, Bottom Leading/Trailing), e as descrições de modo de entrada de Run Shell Script (“to stdin: A entrada será convertida em um arquivo e direcionada ao pipe stdin do script. as arguments: A entrada será convertida em uma lista de strings e passada como argumentos ao script.”). A tabela inclui nomes de actions exclusivos do iOS e legados da era Workflow; as tabelas de catálogo deste guia listam apenas actions relevantes para Mac. 

  17. Parâmetros da action Run Shell Script (seleção de shell, modo de entrada, passagem por stdin/argumentos), conforme as strings de documentação no editor da action verificadas no macOS 26.5; veja também 16

  18. MacMost, “An Introduction To Shortcuts Automation In macOS Tahoe”. Fonte secundária que corrobora a lista completa de gatilhos do Tahoe (incluindo Alarm, Battery Level, Charger, Focus e Stage Manager) e as opções Run Immediately vs Run After Confirmation; categorias primárias de gatilhos conforme 3 e 4

  19. Info.plist do Shortcuts.app, verificado no macOS 26.5: URL schemes registrados shortcuts e workflow (além do interno shortcuts-production) e tipos de documento com.apple.shortcut e com.apple.shortcuts.workflow-file

  20. Apple, “Use x-callback-url with Shortcuts on Mac”, Guia do Usuário do Shortcuts para Mac. Fonte primária para a sintaxe de execução x-callback-url e os parâmetros x-success (com result anexado), x-error (com errorMessage) e x-cancel

  21. Apple, “Use Shortcuts automations in Apple Configurator for Mac”, Guia do Usuário do Apple Configurator. Fonte para suporte a automação do Shortcuts em dispositivos gerenciados. 

  22. Apple, “macOS 27 Release Notes” (Golden Gate Beta 5, 2026-08-10), lido a partir da carga de renderização do DocC JSON porque o HTML é renderizado no cliente. Seção Shortcuts, literalmente — resolvido: “Corrigido: a action Use Model pode falhar ao ser executada ao usar a opção On-Device para alguns tipos de saída. (181071784)”; problemas conhecidos: “Se um app intent usar Duration ou LPLinkMetadata, criar um shortcut com esse intent e tentar editá-lo com "Describe a change" pode falhar. (166068090)” e “As automações Battery Level e Charger podem não funcionar no macOS. (180337087)”. Armazenamento, o inspetor de transcrição Use Model e os tipos de automação Screenshot / Keyboard / Notification vêm da Apple, “What’s new in Shortcuts”, sessão 310 da WWDC26, junho de 2026; a sessão não informa a disponibilidade no macOS desses três gatilhos. Data da beta conferida com Apple Developer Releases. Verificado em 2026-08-16. 

  23. Apple, “macOS Tahoe 26.6 Release Notes”, e a lista Releases, que data o macOS 26.6 (25G72) em 27 de julho de 2026, junto de iOS/iPadOS 26.6 (23G71), tvOS 26.6 (23L773), visionOS 26.6 (23O770) e watchOS 26.6 (23U67). Lido por meio da carga de renderização DocC JSON em developer.apple.com/tutorials/data/documentation/macos-release-notes/macos-26_6-release-notes.json em 2026-07-27, porque a página HTML é renderizada no cliente e não retorna texto para um fetcher. O documento contém exatamente quatro entradas, em CoreStorage (Deprecations, radar 175892336), Ecosystem (Resolved Issues, 174841181 / FB22512943), HealthKit (Resolved Issues, 178157672) e Messages (Resolved Issues, 180859837). Buscas sem diferenciar maiúsculas de minúsculas na carga completa JSON por shortcut, workflowkit, app intents, appintents e automation retornam zero correspondências. Observe que o próprio texto Overview da página ainda diz “macOS Tahoe 26.6 RC” — a Apple ainda não havia atualizado o título no momento desta verificação, embora a lista Releases mostre a build como lançada. 

NORMAL shortcuts.md EOF