apple-reminders

Manage Apple Reminders from the terminal using the remindctl command-line tool.

Updated Sep 10, 2026
One-click install
npx skills add https://github.com/loteiron/ZeusAgent --skill apple-reminders-loteiron
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: apple-reminders
Source: https://github.com/loteiron/ZeusAgent/tree/main/skills/apple/apple-reminders
Command: npx skills add https://github.com/loteiron/ZeusAgent --skill apple-reminders-loteiron

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing Apple Reminders normally requires opening the Reminders app on macOS, which breaks terminal-based workflows. This Skill lets you create, list, complete, and delete reminders directly from the command line, with tasks syncing across all Apple devices via iCloud. ## Core Features & Use Cases - Reminder Management: Add reminders with due dates, alarms, and list assignments, then complete or delete them by ID. - Flexible Views: View reminders for today, tomorrow, this week, overdue items, or specific dates, with JSON, TSV, or count-only output formats. - List Organization: Create, show, and delete Reminders lists to keep personal and work tasks separated. - Use Case: A user says "remind me to call mom tomorrow" and wants it on their iPhone. The Skill creates the reminder with remindctl add --title "Call mom" --list Personal --due tomorrow, and it syncs to iOS via iCloud. ## Quick Start Ask the agent to add a reminder with a title and due date, for example: create an Apple Reminder to buy milk due tomorrow morning.

Frequently Asked Questions about apple-reminders

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

FAQPage Schema
How do I add Apple Reminders from the command line?▼

Use remindctl with the add command, for example: remindctl add --title "Call mom" --list Personal --due tomorrow. It accepts date formats like today, tomorrow, YYYY-MM-DD, and ISO 8601, and the reminder syncs to all Apple devices via iCloud.

How do I set an early notification for an Apple Reminder?▼

Pass the --alarm flag separately from --due, since they are different fields. For a reminder due at 2:00 PM with a 30-minute early nudge: remindctl add --title "Hairdresser" --due "2026-05-15 14:00" --alarm "2026-05-15 13:30".

Does remindctl work on Linux or Windows?▼

No, remindctl only works on macOS because it relies on Apple's EventKit framework and Reminders.app. Install it with brew install steipete/tap/remindctl and grant Reminders permission when prompted.

Why does my reminder show the wrong time in the Reminders app?▼

The Reminders UI may group items by alarm time rather than due time because that is when the notification fires. Verify the actual values with remindctl today --json, which shows dueDate and alarmDate as separate fields.

When should I use Apple Reminders instead of a cronjob alert?▼

Use Apple Reminders when the user wants a personal to-do that syncs to their iPhone or iPad via iCloud. Use the cronjob tool for scheduling agent alerts, and clarify first when a user says "remind me" since the intent can be ambiguous.