apple-reminders

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Apple Reminders

Apple提醒事项

Use

remindctl

to manage Apple Reminders directly from the terminal. Tasks sync across all Apple devices via iCloud.

使用

remindctl

直接从终端管理Apple提醒事项。任务会通过iCloud在所有Apple设备间同步。

Prerequisites

前提条件

macOS with Reminders.app
Install:
```
brew install steipete/tap/remindctl
```
Grant Reminders permission when prompted
Check:
```
remindctl status
```
/ Request:
```
remindctl authorize
```

安装有Reminders.app的macOS系统
安装命令：
```
brew install steipete/tap/remindctl
```
出现提示时授予Reminders权限
检查状态：
```
remindctl status
```
/ 请求授权：
```
remindctl authorize
```

When to Use

适用场景

User mentions "reminder" or "Reminders app"
Creating personal to-dos with due dates that sync to iOS
Managing Apple Reminders lists
User wants tasks to appear on their iPhone/iPad

用户提及“提醒事项”或“Reminders app”
创建带截止日期且同步到iOS的个人待办事项
管理Apple提醒事项列表
用户希望任务显示在他们的iPhone/iPad上

When NOT to Use

不适用场景

Scheduling agent alerts → use the cronjob tool instead
Calendar events → use Apple Calendar or Google Calendar
Project task management → use GitHub Issues, Notion, etc.
If user says "remind me" but means an agent alert → clarify first

调度Agent提醒 → 改用cronjob工具
日历事件 → 使用Apple Calendar或Google Calendar
项目任务管理 → 使用GitHub Issues、Notion等工具
如果用户说“提醒我”但指的是Agent提醒 → 先确认清楚

Quick Reference

快速参考

View Reminders

查看提醒事项

bash

remindctl                    # Today's reminders
remindctl today              # Today
remindctl tomorrow           # Tomorrow
remindctl week               # This week
remindctl overdue            # Past due
remindctl all                # Everything
remindctl 2026-01-04         # Specific date

bash

remindctl                    # 今日的提醒事项
remindctl today              # 今日
remindctl tomorrow           # 明日
remindctl week               # 本周
remindctl overdue            # 逾期
remindctl all                # 所有
remindctl 2026-01-04         # 指定日期

Manage Lists

管理列表

bash

remindctl list               # List all lists
remindctl list Work          # Show specific list
remindctl list Projects --create    # Create list
remindctl list Work --delete        # Delete list

bash

remindctl list               # 列出所有列表
remindctl list Work          # 查看指定列表
remindctl list Projects --create    # 创建列表
remindctl list Work --delete        # 删除列表

Create Reminders

创建提醒事项

bash

remindctl add "Buy milk"
remindctl add --title "Call mom" --list Personal --due tomorrow
remindctl add --title "Meeting prep" --due "2026-02-15 09:00"

bash

remindctl add "Buy milk"
remindctl add --title "Call mom" --list Personal --due tomorrow
remindctl add --title "Meeting prep" --due "2026-02-15 09:00"

Due Time vs Alarm / Early Nudge

截止时间 vs 提醒/提前通知

--due

and

--alarm

are different fields:

```
--due
```
sets the reminder's due date/time.
```
--alarm
```
sets the EventKit alarm/notification trigger. Timed due reminders may default to an alarm at the due time, but pass
```
--alarm
```
explicitly when the user asks for an earlier nudge.

For a reminder due at 2:00 PM with a notification 30 minutes earlier:

bash

remindctl add --title "Hairdresser" --due "2026-05-15 14:00" --alarm "2026-05-15 13:30"

To edit an existing reminder:

bash

remindctl edit 87354 --due "2026-05-15 14:00" --alarm "2026-05-15 13:30"

The Reminders UI may show or group the item by the alarm time because that is when the notification fires. Verify with JSON instead of assuming the due time moved:

bash

remindctl today --json

Expected shape:

```
dueDate
```
: actual due time
```
alarmDate
```
: notification / early nudge time

Apple's public

EKReminder

docs list only reminder-specific properties. Alarm support comes from inherited

EKCalendarItem

behavior exposed by remindctl's

--alarm

flag.

--due

和

--alarm

是不同的字段：

```
--due
```
设置提醒事项的截止日期/时间。
```
--alarm
```
设置EventKit提醒/通知触发时间。带时间的截止提醒可能默认在截止时间触发提醒，但当用户要求提前通知时，请显式使用
```
--alarm
```
参数。

例如，创建一个截止时间为下午2:00、提前30分钟通知的提醒事项：

bash

remindctl add --title "Hairdresser" --due "2026-05-15 14:00" --alarm "2026-05-15 13:30"

编辑现有提醒事项：

bash

remindctl edit 87354 --due "2026-05-15 14:00" --alarm "2026-05-15 13:30"

提醒事项UI可能会按提醒时间显示或分组项目，因为这是通知触发的时间。请通过JSON格式验证，不要假设截止时间已更改：

bash

remindctl today --json

预期格式：

```
dueDate
```
: 实际截止时间
```
alarmDate
```
: 通知/提前通知时间

Apple公开的

EKReminder

文档仅列出提醒事项特有的属性。提醒功能来自继承的

EKCalendarItem

行为，由remindctl的

--alarm

标志暴露。

Complete / Delete

完成/删除

bash

remindctl complete 1 2 3          # Complete by ID
remindctl delete 4A83 --force     # Delete by ID

bash

remindctl complete 1 2 3          # 通过ID标记完成
remindctl delete 4A83 --force     # 通过ID删除

Output Formats

输出格式

bash

remindctl today --json       # JSON for scripting
remindctl today --plain      # TSV format
remindctl today --quiet      # Counts only

bash

remindctl today --json       # 用于脚本的JSON格式
remindctl today --plain      # TSV格式
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
```
)

--due

和日期过滤器接受的格式：

```
today
```
,
```
tomorrow
```
,
```
yesterday
```
```
YYYY-MM-DD
```
```
YYYY-MM-DD HH:mm
```
ISO 8601格式 (
```
2026-01-04T12:34:56Z
```
)

Rules

规则

When user says "remind me", clarify: Apple Reminders (syncs to phone) vs agent cronjob alert
Always confirm reminder content and due date before creating
Use
```
--json
```
for programmatic parsing

当用户说“提醒我”时，确认清楚：是Apple提醒事项（同步到手机）还是Agent cronjob提醒
创建前始终确认提醒内容和截止日期
程序化解析时使用
```
--json
```
格式