viticci/remctl

解決的問題

RemCTL 提供了一個 macOS 提醒事項的命令列介面 (CLI)，讓進階使用者與 AI 代理能夠以程式化的方式管理任務。它透過對提醒事項資料庫提供快速且詳細的存取，克服了標準 API 的限制，包括支援透過基本腳本通常無法存取的進階功能，例如分區、標籤和智慧型列表。

運作方式

RemCTL 使用混合式架構來平衡速度、權限與系統穩定性：

• 讀取路徑：它從本機 iCloud 提醒事項資料庫執行直接的 SQLite 讀取，以近乎即時地存取詳細的元資料。
• 寫入路徑：它使用 Apple 公開的 EventKit API 來確保變更能正確同步到所有裝置。
• 私有 API 路徑：對於進階元資料（如子任務、標籤和雜貨列表分類），它可選擇透過明確的 --private 旗標使用私有的 ReminderKit 框架。
• 權限宿主：為了簡化權限管理，大多數命令會透過已簽署的 RemCTL Capability Host.app 進行路由，該應用程式持有必要的「完全磁碟存取」與「自動化」權限，因此呼叫端的終端機或代理不需要個別擁有這些權限。

適用對象

• macOS 進階使用者：希望透過終端機或 Shell 腳本管理提醒事項的使用者。
• AI 代理：正在建構代理（例如使用 Claude Code 或 Codex）且需要可靠方式與使用者任務列表互動的開發者。

亮點

• 深度整合：支援分區、子任務、標籤、圖片附件和自訂智慧型列表。
• 代理友善：提供 JSON 輸出和結構化的命令映射，易於與 LLM 整合。
• 智慧型列表管理：能夠根據優先順序、日期或旗標建立和編輯自訂的智慧型列表。
• 雜貨列表支援：原生處理雜貨特定的元資料並自動分類。
• 彈性排程：支援類似自然語言的日期解析（例如 "tomorrow 3pm"、"+3d"、"eod"）。