Apple Reminders CLI (remindctl)
Use remindctl to manage Apple Reminders directly from the terminal. It supports list filtering, date-based views, and scripting output.
Setup
- - Install (Homebrew): INLINECODE1
- From source:
pnpm install && pnpm build (binary at ./bin/remindctl) - macOS-only; grant Reminders permission when prompted.
Permissions
- - Check status: INLINECODE4
- Request access: INLINECODE5
View Reminders
- - Default (today): INLINECODE6
- Today: INLINECODE7
- Tomorrow: INLINECODE8
- Week: INLINECODE9
- Overdue: INLINECODE10
- Upcoming: INLINECODE11
- Completed: INLINECODE12
- All: INLINECODE13
- Specific date: INLINECODE14
Manage Lists
- - List all lists: INLINECODE15
- Show list: INLINECODE16
- Create list: INLINECODE17
- Rename list: INLINECODE18
- Delete list: INLINECODE19
Create Reminders
- - Quick add: INLINECODE20
- With list + due: INLINECODE21
Edit Reminders
- - Edit title/due: INLINECODE22
Complete Reminders
- - Complete by id: INLINECODE23
Delete Reminders
- - Delete by id: INLINECODE24
Output Formats
- - JSON (scripting): INLINECODE25
- Plain TSV: INLINECODE26
- Counts only: INLINECODE27
Date Formats
Accepted by --due and date filters:
- -
today, tomorrow, INLINECODE31 - INLINECODE32
- INLINECODE33
- ISO 8601 (
2026-01-04T12:34:56Z)
Notes
- - macOS-only.
- If access is denied, enable Terminal/remindctl in System Settings → Privacy & Security → Reminders.
- If running over SSH, grant access on the Mac that runs the command.
Apple Reminders CLI (remindctl)
使用 remindctl 直接从终端管理 Apple 提醒事项。支持列表过滤、基于日期的视图以及脚本输出。
设置
- - 安装（Homebrew）：brew install steipete/tap/remindctl
- 从源码安装：pnpm install && pnpm build（二进制文件位于 ./bin/remindctl）
- 仅支持 macOS；在提示时授予提醒事项权限。
权限
- - 检查状态：remindctl status
- 请求访问：remindctl authorize
查看提醒事项
- - 默认（今天）：remindctl
- 今天：remindctl today
- 明天：remindctl tomorrow
- 本周：remindctl week
- 逾期：remindctl overdue
- 即将到来：remindctl upcoming
- 已完成：remindctl completed
- 全部：remindctl all
- 特定日期：remindctl 2026-01-04
管理列表
- - 列出所有列表：remindctl list
- 显示列表：remindctl list Work
- 创建列表：remindctl list Projects --create
- 重命名列表：remindctl list Work --rename Office
- 删除列表：remindctl list Work --delete
创建提醒事项
- - 快速添加：remindctl add Buy milk
- 带列表和截止日期：remindctl add --title Call mom --list Personal --due tomorrow
编辑提醒事项
- - 编辑标题/截止日期：remindctl edit 1 --title New title --due 2026-01-04
完成提醒事项
- - 按 ID 完成：remindctl complete 1 2 3
删除提醒事项
- - 按 ID 删除：remindctl delete 4A83 --force
输出格式
- - JSON（脚本使用）：remindctl today --json
- 纯文本 TSV：remindctl today --plain
- 仅计数：remindctl today --quiet
日期格式
--due 和日期过滤器接受的格式：
- - today、tomorrow、yesterday
- YYYY-MM-DD
- YYYY-MM-DD HH:mm
- ISO 8601（2026-01-04T12:34:56Z）
注意事项
- - 仅支持 macOS。
- 如果访问被拒绝，请在系统设置 → 隐私与安全性 → 提醒事项中启用终端/remindctl。
- 如果通过 SSH 运行，请在执行命令的 Mac 上授予访问权限。
