apple-reminders

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

Updated Aug 22, 2026
One-click install
npx skills add https://github.com/vivekgoquest/hermes-agent-stable --skill apple-reminders-vivekgoquest
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: apple-reminders
Source: https://github.com/vivekgoquest/hermes-agent-stable/tree/main/skills/apple/apple-reminders
Command: npx skills add https://github.com/vivekgoquest/hermes-agent-stable --skill apple-reminders-vivekgoquest

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 using remindctl commands. - List Organization: View, create, and delete Reminders lists, and filter tasks by today, tomorrow, week, or overdue. - Scriptable Output: Use JSON, TSV, or quiet output modes 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 a due date via remindctl, and it syncs to iOS through iCloud. ## Quick Start Ask the agent to add a reminder with a specific title and due date, such as creating 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 command line?▼

Use remindctl add with a title and optional flags like --list and --due. For example, remindctl add --title "Call mom" --list Personal --due tomorrow creates a reminder that syncs to your Apple devices via iCloud.

How do I install remindctl on macOS?▼

Install remindctl via Homebrew with brew install steipete/tap/remindctl. After installation, grant Reminders permission when prompted, or check status with remindctl status and request access with remindctl authorize.

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 an earlier notification, such as 30 minutes before the due time.

Does remindctl work on Windows or Linux?▼

No, remindctl only works on macOS because it relies on Apple's EventKit framework and Reminders.app. Tasks created with it sync across Apple devices through iCloud, but the tool itself requires a Mac.

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 an agent cronjob when you need the agent itself to trigger an alert or scheduled automation.