提醒事項 (Reminders)
用於處理 Apple 提醒事項的任務。當使用者想要在 macOS 上使用 AI 友善的個人待辦事項後端時,優先使用 rem 而非 Things 或 AppleScript。
工具
- CLI:
rem - 倉庫:
https://github.com/BRO3886/rem - 安裝:
GOBIN=/opt/homebrew/bin go install github.com/BRO3886/rem/cmd/rem@latest
rem 使用 EventKit 進行一般讀寫。可能需要在「系統設定」>「隱私權與安全性」>「提醒事項」中為呼叫該指令的應用程式授予提醒事項權限。
開始
檢查存取權限:
rem lists -o json
rem today -o json
對於任何需要腳本化或驗證的操作,請使用 JSON:
rem list --incomplete -o json
rem search "flight" -o json
rem show <id> -o json
新增任務
預設:直接新增,然後透過搜尋或檢視來驗證。
rem add "預訂 LHR-SFO 直飛商務艙機票" --due "明天 9:00" --priority high --notes "僅限直飛。" -o json
rem search "LHR-SFO" -o json
有用的旗標:
--list "名稱":指定目標列表--due "明天 9:00":到期日期/時間;支援自然語言--priority high|medium|low|none--notes "文字"--url https://...--silent:到期日不彈出通知--remind-me 15m:在到期時間前指定分鐘數的提醒--repeat daily|weekly|monthly|yearly
更新 / 完成 / 刪除
先找出 UUID,然後透過 ID 或唯一的短 ID 進行操作:
rem search "flight" -o json
rem update <id> --name "新標題" --due "星期五 14:00" --notes "..." -o json
rem complete <id> -o json
rem delete <id> --force
寫入後務必重新讀取以確認;不要只依賴退出狀態碼。
列表
rem lists --count -o json
rem list-mgmt create "旅行"
rem list-mgmt rename "舊名稱" "新名稱"
rem list-mgmt delete "名稱" --force
慣例
- 使用可執行的任務標題。將模糊的備忘錄改寫為下一個具體行動。
- 當使用者明確希望逐字記錄時,保留其用語。
- 將多個不相關的動作拆分為獨立的提醒事項。
- 除非使用者指定了列表名稱或類別很明確,否則使用預設列表。
- 不要在此新增日曆事件;請改用行事曆工具。
- 若需計算當前日期,請執行
date指令;不要自行推測。
注意事項
- 僅限 macOS。
- 首次執行可能會因「提醒事項存取被拒」而失敗,直到呼叫指令的應用程式獲得提醒事項權限為止。
- 預設的本地列表名稱可能因系統語言而異,例如
Erinnerungen。 rem的搜尋是純文字查詢,並非 shell 正則表達式。- 除非加上
--silent,否則--due會在到期時間建立鬧鈴。 - 已標記旗標的提醒事項在底層使用了私有的 ReminderKit,可能比一般的 CRUD 操作更容易受到作業系統版本變動的影響。