Apple Reminders

• 您想要在不離開終端機或切換到 GUI 應用程式的情況下，快速新增、完成或查看提醒事項。
• 您正在建立需要以程式方式讀取或寫入 Apple Reminders 的 shell 腳本或 AI 代理工作流程。
• 您需要來自 Apple Reminders 的結構化輸出（JSON 或 TSV），以供其他工具或管道使用。
• 您想要透過 SSH 在 Mac 上管理提醒事項，而無需開啟「提醒事項」應用程式。

• 您不是在 macOS 上運行 — 此工具僅限 Darwin 系統，無法在 Linux 或 Windows 上使用。
• 您使用第三方任務管理工具（Todoist、Things、OmniFocus 等），而非原生的 Apple Reminders 應用程式。
• 您需要跨非 Apple 平台的 iCloud 同步可見性；remindctl 僅在本地 macOS Reminders 資料庫上運作。

透過 today、tomorrow、week、overdue、upcoming、completed 或指定的 YYYY-MM-DD 日期，快速篩選提醒事項。這讓您無需撰寫任何查詢邏輯，即可輕鬆建立每日摘要或查看逾期未完成的項目。

使用 add 建立提醒事項，使用 edit 更新標題與到期日，使用 complete 將一個或多個提醒標記為完成，並使用 delete --force 永久刪除它們。所有操作均透過提醒事項的 ID 來指定目標。

從命令列檢視所有 Apple Reminders 清單、顯示特定清單中的提醒事項，以及建立、重新命名或刪除清單。

以 --json 輸出結構化資料管線結果、以 --plain 輸出以定位字元分隔的值，或以 --quiet 僅輸出計數。這使 remindctl 能輕鬆整合至 shell 腳本、自動化工具及 AI 代理程式中。

在設定或篩選到期日期時，支援自然語言縮寫（today、tomorrow）、YYYY-MM-DD、YYYY-MM-DD HH:mm 以及完整的 ISO 8601 時間戳記格式。

在工作階段開始時執行 remindctl today --json，以結構化格式呈現今日所有到期的 Apple Reminders 提醒事項，讓 AI 代理人能將其與行事曆活動或訊息一併進行摘要整理。

使用 remindctl add --title "Review PR" --list Work --due tomorrow 來擷取任務，無需切換至 Apple Reminders 應用程式，讓你保持專注於終端機中。

執行 remindctl overdue 查看所有已逾期的項目，接著使用 remindctl complete 1 2 3 以單一指令將多個 Apple Reminders 提醒標記為完成。

將 remindctl week --plain 透過管道傳入其他 shell 工具或自動化腳本，即可在無需任何圖形介面互動的情況下，對即將到來的 Apple Reminders 提醒進行處理、篩選或報告。