apple-reminders

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

5|2|Updated May 26, 2026
One-click install
npx skills add https://github.com/perasyudha/Nyxora --skill apple-reminders-perasyudha
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: apple-reminders
Source: https://github.com/perasyudha/Nyxora/tree/main/packages/core/playbooks/apple/apple-reminders
Command: npx skills add https://github.com/perasyudha/Nyxora --skill apple-reminders-perasyudha

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing Apple Reminders normally requires opening the Reminders app on macOS, which breaks terminal-based and agent-driven 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 - Create and schedule reminders: Add reminders with due dates, lists, and separate alarm times for early notifications using remindctl. - Query and filter tasks: View reminders for today, tomorrow, this week, overdue items, or specific dates, with JSON 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 at 6pm" — the agent runs remindctl to create the reminder, which then syncs to the user's iPhone via iCloud. ## Quick Start Ask the agent to add a reminder with a title and due date, for example: create a reminder to buy milk tomorrow using Apple Reminders.

Frequently Asked Questions about apple-reminders

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

FAQPage Schema
How do I create an Apple Reminder from the command line?

Use remindctl with the add command, 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 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 Apple Reminders?

The --due flag sets the reminder's due date and time, while --alarm sets the notification trigger time. 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 output, --plain for TSV, or --quiet for counts only, making it suitable for programmatic parsing 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. It is meant for personal to-dos that sync to iOS devices.