核心功能
timely 是一款专为 macOS 设计的命令行工具，通过调用 Apple EventKit 框架实现无界面操作 Apple 提醒事项。支持两大核心场景：时间触发（自然语言解析）和地理位置围栏触发（到达/离开），所有提醒通过 iCloud 自动同步至 iPhone、iPad 等设备。
显著优点
- 零交互自动化：完全绕过 Reminders.app GUI，适合脚本集成与快捷键工作流
- 自然语言时间解析：支持 "tomorrow 3pm"、"next friday" 等直观输入
- 精确地理围栏：基于真实地址坐标触发，区分到达（--arrive）与离开（--depart）两种事件
- 多设备同步：依赖原生 iCloud 基础设施，无需额外配置
- 共享列表支持：可直接操作家庭共享的提醒列表
潜在局限
- macOS 独占：仅支持 Darwin 系统，Linux/Windows 用户无法使用
- 首次授权门槛：必须手动授予提醒事项隐私权限，无法静默完成
- 地理编码依赖：地址解析依赖 Apple 地图服务，部分偏远地区可能偏差
- 半径不可调：默认 100 米围栏半径，无法自定义（系统限制）
- 无提醒修改/删除：当前版本仅支持创建与查看，不支持编辑或删除已有提醒
适合人群
- 重度 Terminal 用户与自动化爱好者（Alfred/Shortcuts/Keyboard Maestro 集成）
- 需要批量创建提醒的开发者与项目经理
- 依赖位置记忆的 ADHD 或 GTD 实践者
- 跨 macOS/iOS 生态的深度用户
常规风险提示
- 隐私权限：需永久授权访问全部提醒事项数据库，包含潜在敏感内容
- 数据持久性：操作直接写入 iCloud，误创建后需手动跨设备清理
- 地理围栏电量：频繁位置监控可能轻微增加 iPhone 电池消耗
- brew 第三方源：当前托管于个人 tap（halbotley/tap），建议关注上游安全更新