apple-reminders

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

Updated Aug 19, 2026
One-click install
npx skills add https://github.com/jakubbartnik/honey-barrel-finale --skill apple-reminders-jakubbartnik
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: apple-reminders
Source: https://github.com/jakubbartnik/honey-barrel-finale/tree/main/honey-barrel-finale/workspace/hermes/skills/apple/apple-reminders
Command: npx skills add https://github.com/jakubbartnik/honey-barrel-finale --skill apple-reminders-jakubbartnik

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 - Reminder Management: Add, view, complete, and delete reminders with due dates, alarms, and list assignments using remindctl commands. - List Organization: Create, view, and delete Reminders lists to organize personal and work tasks. - Structured Output: Use --json, --plain, or --quiet output formats for scripting and programmatic parsing. - Use Case: A user says "remind me to call mom tomorrow" and wants it on their iPhone. The Skill creates the reminder with a due date via remindctl, and it syncs to iOS through iCloud. ## Quick Start Ask the assistant to add a reminder with a specific 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 your 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 if needed.

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

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.

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. The skill explicitly targets macOS platforms and requires Reminders.app permissions.

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 agent itself to notify you or trigger an action at a scheduled time.