apple-reminders

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Apple Reminders

Use

remindctl

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

使用

remindctl

直接从终端管理Apple Reminders。任务通过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 Reminders列表
用户希望任务显示在其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"

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 Reminders（同步到手机）还是Agent cronjob提醒
创建提醒事项前，务必确认内容和截止日期
如需程序化解析，使用
```
--json
```
格式