apple-reminders

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

Updated Sep 20, 2026
One-click install
npx skills add https://github.com/GreenyZA/neo-light --skill apple-reminders-greenyza
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: apple-reminders
Source: https://github.com/GreenyZA/neo-light/tree/main/.hermes-home/skills/apple/apple-reminders
Command: npx skills add https://github.com/GreenyZA/neo-light --skill apple-reminders-greenyza

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 titles, due dates, alarms, and list assignments using remindctl commands. - List Organization: View, create, and delete Reminders lists, and filter reminders by today, tomorrow, week, overdue, or specific dates. - Scriptable Output: Use JSON, TSV, or quiet output formats for programmatic parsing and automation. - 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" --due tomorrow, and it syncs to iOS via iCloud. ## 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 Apple Reminders from the terminal?▼

Use remindctl with the add command, for example `remindctl add --title "Call mom" --list Personal --due tomorrow`. The reminder syncs across Apple devices via iCloud once Reminders permission is granted.

How to install remindctl on macOS?▼

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

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

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

Can I get Apple Reminders output as JSON for scripting?▼

Yes, remindctl supports multiple output formats. Use `--json` for structured JSON parsing, `--plain` for TSV format, or `--quiet` for counts only, making it suitable for shell scripts and automation.

When should I not use Apple Reminders for reminders?▼

Avoid Apple Reminders for scheduling agent alerts, which belong in a cronjob tool, and for calendar events, which belong in Apple or Google Calendar. Project task management is better handled by GitHub Issues or Notion.