apple-reminders

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing Apple Reminders normally requires opening the Reminders app on macOS, which interrupts terminal-based workflows. This Skill lets you create, list, complete, and delete reminders directly from the command line, with all tasks syncing across Apple devices via iCloud. ## Core Features & Use Cases - Reminder Management: Add reminders with due dates, alarms, and list assignments, then complete or delete them by ID. - Flexible Views: Query reminders for today, tomorrow, this week, overdue items, or specific dates, with JSON, TSV, or count-only output formats. - List Organization: Create, view, and delete Reminders lists to keep personal and work tasks separated. - 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 all their Apple devices via iCloud. ## Quick Start Use the apple-reminders skill to create a reminder titled "Buy milk" due tomorrow in my 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 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 list today's reminders in the terminal?▼

Run `remindctl today` to show reminders due today, or `remindctl` alone for the same default view. Other views include tomorrow, week, overdue, all, or a specific date like `remindctl 2026-01-04`.

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. It requires macOS with Reminders permission granted to the terminal.

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 notification trigger time. Pass `--alarm` explicitly when you want a notification earlier than the due time, such as 30 minutes before.

When should I not use Apple Reminders for tasks?▼

Avoid it for scheduling agent alerts, which belong in a cronjob tool, and for project task management, which fits GitHub Issues or Notion better. It is designed for personal to-dos that sync to iOS devices.