apple-reminders

Manage Apple Reminders from the terminal using the remindctl CLI on macOS.

115|9|Updated Aug 5, 2026
One-click install
npx skills add https://github.com/AtlasOmnia/donna-starter --skill apple-reminders-atlasomnia
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: apple-reminders
Source: https://github.com/AtlasOmnia/donna-starter/tree/main/skills/apple/apple-reminders
Command: npx skills add https://github.com/AtlasOmnia/donna-starter --skill apple-reminders-atlasomnia

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It lets you create, view, complete, and delete Apple Reminders directly from the terminal, with tasks syncing across all Apple devices via iCloud, without opening the Reminders app. ## Core Features & Use Cases - Reminder Management: Add reminders with due dates, alarms, and list assignments using remindctl commands. - Flexible Views: Query reminders by today, tomorrow, week, overdue, or specific dates, with JSON, TSV, or count-only output formats. - List Organization: Create, view, and delete Reminders lists to keep tasks organized. - Use Case: A user says "remind me to call mom tomorrow" and the assistant creates an Apple Reminder that syncs to their iPhone, after clarifying they want a synced reminder rather than an agent cronjob alert. ## Quick Start Ask the assistant to add a reminder with a title and due date, for example to create a reminder to buy milk due tomorrow in your Personal list.

Frequently Asked Questions about apple-reminders

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add an Apple Reminder from the terminal?

Use remindctl add with a title and optional due date, for example remindctl add --title "Call mom" --list Personal --due tomorrow. The reminder syncs to all Apple devices through iCloud once created.

How do I set an early notification for a reminder with remindctl?

Pass --alarm separately from --due, since --due sets the due time while --alarm sets the notification trigger. For example, use --due "2026-05-15 14:00" --alarm "2026-05-15 13:30" for a 30-minute early nudge.

Does remindctl support subtasks or parent reminders?

No, remindctl 0.1.1 only creates and edits flat reminders with no subtask operations in add or edit. For reorganizing subtasks, use the Reminders UI or, cautiously, the local SQLite store after backing it up.

Why does remindctl list hang or time out?

Broad list commands like remindctl list --all can hang, with timeouts observed after 180 seconds. Use scoped queries like remindctl today, week, or a specific date, or wrap broad queries in a timeout command.

What should I use instead of Apple Reminders for agent alerts?

Use the cronjob tool for scheduling agent alerts rather than Apple Reminders. When a user says "remind me", clarify whether they want a synced Apple Reminder or an agent-triggered alert before acting.