apple-reminders¶

Skill 简介¶

apple-reminders 是一个通过 remindctl 命令行工具来管理 Apple Reminders 的技能，旨在为开发者提供一种便捷、高效的方式，在终端中直接操作苹果的提醒事项。通过这个技能，用户可以轻松地查看、创建、编辑、标记完成以及删除提醒事项，同时支持按照列表、日期过滤和多种输出格式进行操作。

对于那些习惯于使用命令行工具进行日常任务管理的开发者而言，apple-reminders 提供了一个无缝衔接的解决方案。它不仅能帮助你快速管理个人或工作相关的待办事项，还能确保这些任务能够实时同步到你的 iPhone、iPad 等苹果设备上，实现跨设备的无缝体验。

主要功能¶

1. 查看提醒事项
remindctl 提供了多种查看提醒事项的方式，用户可以根据自己的需求选择不同的命令：

remindctl                    # 查看今天的提醒事项
remindctl today              # 同上，查看今天的提醒事项
remindctl tomorrow           # 查看明天的提醒事项
remindctl week               # 查看本周的提醒事项
remindctl overdue            # 查看已过期的提醒事项
remindctl all                # 查看所有提醒事项
remindctl 2026-01-04         # 查看特定日期的提醒事项

通过这些命令，用户可以快速获取到不同时间范围内的提醒事项，方便进行任务安排。

2. 管理提醒列表
用户可以创建、查看和删除不同的提醒列表，以便对任务进行分类管理：

remindctl list               # 查看所有提醒列表
remindctl list Work          # 查看名为 "Work" 的提醒列表
remindctl list Projects --create    # 创建一个名为 "Projects" 的新列表
remindctl list Work --delete        # 删除名为 "Work" 的提醒列表

这种列表管理功能可以帮助用户更好地组织任务，提高工作效率。

3. 创建提醒事项
用户可以通过简单的命令创建新的提醒事项，并可以指定标题、列表和截止日期：

remindctl add "Buy milk"                     # 创建一个简单的提醒事项
remindctl add --title "Call mom" --list Personal --due tomorrow    # 创建一个带有标题、列表和截止日期的提醒事项
remindctl add --title "Meeting prep" --due "2026-02-15 09:00"      # 创建一个带有具体截止时间的提醒事项

这些命令支持多种参数组合，使用户能够灵活地创建各种类型的提醒事项。

4. 完成或删除提醒事项
用户可以通过指定提醒事项的 ID 来标记完成或删除提醒事项：

remindctl complete 1 2 3     # 标记 ID 为 1、2、3 的提醒事项为完成
remindctl delete 4A83 --force  # 强制删除 ID 为 4A83 的提醒事项

这种操作方式简单直观，方便用户快速管理已完成或不再需要的任务。

5. 多样化的输出格式
remindctl 支持多种输出格式，包括 JSON 和纯文本（TSV），方便用户进行脚本处理或数据导出：

remindctl today --json       # 以 JSON 格式输出今天的提醒事项
remindctl today --plain      # 以 TSV 格式输出今天的提醒事项
remindctl today --quiet      # 仅输出提醒事项的数量

这种多样化的输出方式为开发者提供了更大的灵活性，可以根据需要进行数据处理和分析。

使用场景¶

1. 日常任务管理
   开发者可以使用 apple-reminders 来管理日常的个人和工作任务，例如会议安排、项目进度跟踪等。通过命令行操作，可以快速创建和查看任务，提高工作效率。

2. 跨设备同步
   由于 Apple Reminders 支持跨设备同步，开发者可以在 macOS 上通过 remindctl 创建任务，这些任务会自动同步到 iPhone、iPad 等设备上，方便随时随地查看和管理。

3. 数据导出与分析
   通过 remindctl 的 JSON 输出功能，开发者可以将提醒事项数据导出到其他工具进行进一步的分析和处理，例如生成任务报告、统计任务完成情况等。

4. 自动化任务管理
   结合其他命令行工具，开发者可以实现提醒事项的自动化管理，例如定时创建任务、自动标记完成等，提高任务管理的自动化程度。

如何使用¶

安装¶

首先，确保你的系统已经安装了 Homebrew。如果尚未安装，可以参考 Homebrew 官网 进行安装。

然后，通过以下命令安装 remindctl：

brew install steipete/tap/remindctl

配置¶

安装完成后，需要授予 Reminders 访问权限。在终端中运行以下命令：

remindctl authorize

按照提示完成授权即可。

常用命令¶

查看今天的提醒事项：

remindctl today

创建一个新的提醒事项：

remindctl add "Buy milk"

创建一个带有标题、列表和截止日期的提醒事项：

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

标记提醒事项为完成：

remindctl complete 1 2 3

删除提醒事项：

remindctl delete 4A83 --force

示例¶

示例 1：创建和管理提醒事项¶

1. 创建一个新的提醒事项：
   bash remindctl add "Submit project report"
2. 查看今天的提醒事项：
   bash remindctl today
3. 标记提醒事项为完成：
   bash remindctl complete 1
4. 删除已完成的任务：
   bash remindctl delete 1 --force

示例 2：使用 JSON 格式导出数据¶

1. 导出今天的提醒事项为 JSON 格式：
   bash remindctl today --json > reminders.json
2. 使用 jq 工具进行数据处理：
   bash cat reminders.json | jq '.[] | {title, due}'

总结¶

apple-reminders 是一个功能强大且易于使用的技能，专为那些希望在终端中高效管理 Apple Reminders 的开发者设计。通过 remindctl，用户可以轻松地创建、查看、编辑和删除提醒事项，同时享受跨设备同步和多样化的输出格式带来的便利。无论是日常任务管理还是数据导出与分析，apple-reminders 都能满足开发者的需求，提高工作效率。对于那些经常使用命令行工具的开发者而言，apple-reminders 是一个不可或缺的利器。