apple-reminders

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

Updated Dec 7, 2025
One-click install
npx skills add https://github.com/harlanljones/dotfiles --skill apple-reminders-harlanljones
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: apple-reminders
Source: https://github.com/harlanljones/dotfiles/tree/main/dot_hermes/skills/apple/apple-reminders
Command: npx skills add https://github.com/harlanljones/dotfiles --skill apple-reminders-harlanljones

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires remindctl.

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 everything syncing to your iPhone and iPad via iCloud. ## Core Features & Use Cases - Create and Schedule Reminders: Add reminders with due dates, alarms, and list assignments using natural date formats like "tomorrow" or ISO 8601. - View and Filter Tasks: Query reminders by today, tomorrow, week, overdue, or specific dates, with JSON, TSV, or count-only output for scripting. - List Management: Create, view, and delete Reminders lists to organize personal and work tasks. - Use Case: A user says "remind me to call mom tomorrow" and wants it on their iPhone. The Skill creates the reminder via remindctl with the correct due date, and it syncs across all Apple devices automatically. ## Quick Start Ask the assistant to add a reminder such as "remind me to buy milk tomorrow" and it will create the entry in Apple Reminders using remindctl.

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 add with a title and optional due date, such as remindctl add --title "Call mom" --due tomorrow. The reminder syncs to all Apple devices through iCloud once created.

How do I install remindctl on macOS?▼

Install remindctl via Homebrew with brew install steipete/tap/remindctl. After installation, run remindctl status to check permissions and remindctl authorize to request Reminders access.

What is the difference between due date and alarm in remindctl?▼

The --due flag sets the reminder's actual due date, while --alarm sets the notification trigger time. Pass --alarm explicitly when you want an earlier nudge, such as 30 minutes before the due time.

Does remindctl work on Linux or Windows?▼

No, remindctl only works on macOS because it relies on Apple's EventKit framework and the Reminders app. Linux and Windows users need a different task management tool.

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

Use Apple Reminders when you want a personal to-do that syncs to your iPhone or iPad via iCloud. Use a cronjob or agent alert when you need the system or agent itself to notify you at a scheduled time.