apple-reminders

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Apple Reminders CLI (remindctl)

Apple提醒事项 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):
```
brew install steipete/tap/remindctl
```

From source:

pnpm install && pnpm build

(binary at

./bin/remindctl

)

macOS-only; grant Reminders permission when prompted.

Permissions

Check status:
```
remindctl status
```
Request access:
```
remindctl authorize
```

View Reminders

Default (today):
```
remindctl
```
Today:
```
remindctl today
```
Tomorrow:
```
remindctl tomorrow
```
Week:
```
remindctl week
```
Overdue:
```
remindctl overdue
```
Upcoming:
```
remindctl upcoming
```
Completed:
```
remindctl completed
```
All:
```
remindctl all
```
Specific date:
```
remindctl 2026-01-04
```

Manage Lists

List all lists:
```
remindctl list
```
Show list:
```
remindctl list Work
```
Create list:
```
remindctl list Projects --create
```
Rename list:
```
remindctl list Work --rename Office
```
Delete list:
```
remindctl list Work --delete
```

Create Reminders

Quick add:
```
remindctl add "Buy milk"
```

With list + due:

remindctl add --title "Call mom" --list Personal --due tomorrow

Edit Reminders

Edit title/due:

remindctl edit 1 --title "New title" --due 2026-01-04

Complete Reminders

Complete by id:
```
remindctl complete 1 2 3
```

Delete Reminders

Delete by id:
```
remindctl delete 4A83 --force
```

Output Formats

JSON (scripting):
```
remindctl today --json
```
Plain TSV:
```
remindctl today --plain
```
Counts only:
```
remindctl today --quiet
```

Date Formats Accepted by

--due

and date filters:

```
today
```
,
```
tomorrow
```
,
```
yesterday
```
```
YYYY-MM-DD
```
```
YYYY-MM-DD HH:mm
```
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.

使用

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系统。
如果权限被拒绝，请在系统设置→隐私与安全性→提醒事项中启用Terminal/remindctl的权限。
如果通过SSH运行，请在执行命令的Mac上授予权限。