什么是 Apple 提醒事项 CLI？

Apple 提醒事项 CLI 技能在您的终端与原生 macOS 提醒事项应用之间架起了一座直接的桥梁。通过利用 remindctl 工具，该技能允许用户和 AI 代理以编程方式列出、创建、编辑和删除提醒事项，而无需打开图形界面。它专为希望将系统级任务管理集成到其 Openclaw 技能开发工作流中的开发者而设计。

这种集成对于维持高速环境特别有价值，在开发过程中一旦识别出任务即可立即捕获。无论您是按日期筛选、管理多个列表，还是为脚本输出数据，此技能都能确保您的 Apple 提醒事项生态系统保持可访问和自动化。

下载入口:https://github.com/openclaw/skills/tree/main/skills/steipete/apple-reminders

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

npx clawhub@latest install apple-reminders

2. 手动安装

将技能文件夹复制到以下位置之一

全局模式 ~/.openclaw/skills/ 工作区 <project>/skills/

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

请帮我使用 Clawhub 安装 apple-reminders。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。

Apple 提醒事项 CLI 应用场景

• 直接从终端为代码审查或错误修复创建快速提醒。
• 使用 JSON 输出生成自动化的每日任务摘要以进行报告。
• 根据特定 ID 或列表批量完成或删除任务。
• 使用专用的 CLI 命令管理特定项目的待办事项列表。
• 筛选即将到期或的任务，以便在开发期间掌握截止日期。

Apple 提醒事项 CLI 工作原理

1. 该技能调用 remindctl 二进制文件与 macOS EventKit 框架进行交互。
2. 解析命令以确定操作，如添加任务、列出提醒事项或修改列表。
3. 工具向 macOS 请求必要的隐私权限以访问提醒事项数据库。
4. 在本地数据库中检索或修改任务，并以请求的格式（纯文本、TSV 或 JSON）返回结果。
5. 用户随后可以在更大的自动化流水线或 Openclaw 技能工作流中利用这些结果。

Apple 提醒事项 CLI 配置指南

要开始使用此技能，请确保您使用的是 macOS 并按照以下步骤操作：

# 通过 Homebrew 安装 remindctl 工具
brew install steipete/tap/remindctl

# 验证安装并检查权限状态
remindctl status

# 授权 CLI 访问您的提醒事项
remindctl authorize

如果访问被拒绝，请导航至系统设置 > 隐私与安全性 > 提醒事项，并确保您的终端模拟器或 remindctl 已启用。

Apple 提醒事项 CLI 数据架构与分类体系

该技能使用结构化输出处理数据，以确保与其他工具的兼容性。以下是主要的数据组织结构：

功能	详情
输出格式	支持用于自动化的 --json，用于 TSV 的 --plain，以及用于计数的 --quiet。
日期格式	接受 today、tomorrow、YYYY-MM-DD 和 ISO 8601 字符串。
任务元数据	包括标题、列表名称、截止日期和用于定位的唯一 ID。
列表操作	支持创建、重命名和删除整个命名的列表。

name: apple-reminders
description: Manage Apple Reminders via the `remindctl` CLI on macOS (list, add, edit, complete, delete). Supports lists, date filters, and JSON/plain output.
homepage: https://github.com/steipete/remindctl
metadata: {"clawdbot":{"emoji":"?","os":["darwin"],"requires":{"bins":["remindctl"]},"install":[{"id":"brew","kind":"brew","formula":"steipete/tap/remindctl","bins":["remindctl"],"label":"Install remindctl via Homebrew"}]}}

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): 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.