用途:event CLI 让你在终端管理 Apple Reminders 和 Calendar,可创建、查看、搜索、更新、删除提醒与日历事件,并跨设备同步。
主要能力:提醒支持列表/搜索/按列表或到期窗口筛选、创建(标题、清单、到期、优先级、备注、多行备注、标签、标记、URL、位置触发)、更新(完成、标题、优先级、清除日期/位置)、删除及清单管理;子任务通过父标题字段实现。日历支持列出与筛选、创建定时或全天事件、更新和删除。
使用方式:命令形如 event reminders list、event reminders create --title "Buy groceries"、event calendar list、event calendar create --title "Standup" --start "2026-03-10 09:00:00" --end "2026-03-10 09:30:00"。日期格式限 yyyy-MM-dd HH:mm:ss,全天用 yyyy-MM-dd;优先级 1 高、5 中、9 低、0 无。所有命令支持 --json。
同步:event sync 执行双向同步,event sync status 查看状态,event sync config --api-url <URL> --api-token <TOKEN> 配置后端。同步依赖 Cloudflare D1,需设置 EVENT_SYNC_API_URL、EVENT_SYNC_API_TOKEN,提醒与日历事件用 EVENT_ENCRYPTION_KEY 端到端加密,各设备必须一致。
平台与限制:macOS 通过 EventKit 读写,需在系统设置授予完全访问权限;Linux 使用本地 SQLite(~/.local/share/event-sync/local.db),需先 event sync 填充数据。标签、标记、URL、父子关系依赖 AdvancedReminderEdit 快捷指令,缺失时会被跳过;这些字段不参与同步。日历同步仅覆盖过去一年到未来两年窗口。备注按纯文本处理,不支持 Markdown。详情参见 references/cloud-sync.md。