Apple Reminders

• Você quer adicionar, concluir ou revisar lembretes rapidamente sem sair do terminal ou alternar para um aplicativo com interface gráfica.
• Você está criando scripts de shell ou fluxos de trabalho de agentes de IA que precisam ler ou gravar no Apple Reminders de forma programática.
• Você precisa de saída estruturada (JSON ou TSV) do Apple Reminders para alimentar outras ferramentas ou pipelines.
• Você quer gerenciar lembretes via SSH em um Mac sem abrir o aplicativo Lembretes.

• Você não está no macOS — esta ferramenta é exclusiva para Darwin e não funcionará no Linux ou Windows.
• Você usa um gerenciador de tarefas de terceiros (Todoist, Things, OmniFocus, etc.) em vez do aplicativo nativo Apple Reminders.
• Você precisa de visibilidade de sincronização via iCloud em plataformas não Apple; o remindctl opera apenas no banco de dados local do Apple Reminders no macOS.

Filtre rapidamente os lembretes por today (hoje), tomorrow (amanhã), week (semana), overdue (atrasados), upcoming (próximos), completed (concluídos) ou uma data específica no formato YYYY-MM-DD. Isso facilita a criação de resumos diários ou a verificação do que está atrasado sem precisar escrever nenhuma lógica de consulta.

Crie lembretes com add, atualize títulos e datas de vencimento com edit, marque um ou vários como concluídos com complete e remova-os permanentemente com delete --force. Todas as operações identificam os lembretes pelo seu ID.

Visualize todas as listas do Apple Reminders, exiba lembretes de uma lista específica e crie, renomeie ou exclua listas — tudo pela linha de comando.

Exporte resultados como --json para pipelines de dados estruturados, --plain para valores separados por tabulação, ou --quiet apenas para contagens. Isso torna o remindctl fácil de integrar em scripts de shell, ferramentas de automação e agentes de IA.

Aceita abreviações em linguagem natural (today, tomorrow), YYYY-MM-DD, YYYY-MM-DD HH:mm e timestamps completos no formato ISO 8601 ao definir ou filtrar por datas de vencimento.

Execute remindctl today --json no início de uma sessão para exibir todos os lembretes com vencimento hoje em um formato estruturado, permitindo que um agente de IA os resuma junto com eventos do calendário ou mensagens.

Use remindctl add --title "Review PR" --list Work --due tomorrow para capturar uma tarefa sem precisar alternar para o aplicativo Apple Reminders, mantendo o foco no terminal.

Execute remindctl overdue para ver todos os itens com prazo vencido, depois use remindctl complete 1 2 3 para marcar vários lembretes como concluídos em um único comando.

Redirecione remindctl week --plain para outras ferramentas de shell ou scripts de automação para processar, filtrar ou gerar relatórios sobre lembretes futuros sem nenhuma interação com interface gráfica.