apple-reminders

Original：🇺🇸 English
Translated

Apple Reminders via remindctl: add, list, complete.

2installs
Sourcenousresearch/hermes-agent
Added on

NPX Install

npx skill4agent add nousresearch/hermes-agent apple-reminders

Tags

Translated version includes tags in frontmatter
apple-remindersremindctlterminal-task-managementmacos-toolscross-device-sync

SKILL.md Content

View Translation Comparison →

Apple Reminders

Use 
remindctl
to manage Apple Reminders directly from the terminal. Tasks sync across all Apple devices via iCloud.

Prerequisites

  • macOS with Reminders.app
  • Install: 
    brew install steipete/tap/remindctl
  • Grant Reminders permission when prompted
  • Check: 
    remindctl status
    / Request: 
    remindctl authorize

When to Use

  • User mentions "reminder" or "Reminders app"
  • Creating personal to-dos with due dates that sync to iOS
  • Managing Apple Reminders lists
  • User wants tasks to appear on their iPhone/iPad

When NOT to Use

  • Scheduling agent alerts → use the cronjob tool instead
  • Calendar events → use Apple Calendar or Google Calendar
  • Project task management → use GitHub Issues, Notion, etc.
  • If user says "remind me" but means an agent alert → clarify first

Quick Reference

View Reminders

bash
remindctl                    # Today's reminders
remindctl today              # Today
remindctl tomorrow           # Tomorrow
remindctl week               # This week
remindctl overdue            # Past due
remindctl all                # Everything
remindctl 2026-01-04         # Specific date

Manage Lists

bash
remindctl list               # List all lists
remindctl list Work          # Show specific list
remindctl list Projects --create    # Create list
remindctl list Work --delete        # Delete list

Create Reminders

bash
remindctl add "Buy milk"
remindctl add --title "Call mom" --list Personal --due tomorrow
remindctl add --title "Meeting prep" --due "2026-02-15 09:00"

Due Time vs Alarm / Early Nudge

--due
and 
--alarm
are different fields:
  • --due
    sets the reminder's due date/time.
  • --alarm
    sets the EventKit alarm/notification trigger. Timed due reminders may default to an alarm at the due time, but pass 
    --alarm
    explicitly when the user asks for an earlier nudge.
For a reminder due at 2:00 PM with a notification 30 minutes earlier:
bash
remindctl add --title "Hairdresser" --due "2026-05-15 14:00" --alarm "2026-05-15 13:30"
To edit an existing reminder:
bash
remindctl edit 87354 --due "2026-05-15 14:00" --alarm "2026-05-15 13:30"
The Reminders UI may show or group the item by the alarm time because that is when the notification fires. Verify with JSON instead of assuming the due time moved:
bash
remindctl today --json
Expected shape:
  • dueDate
    : actual due time
  • alarmDate
    : notification / early nudge time
Apple's public 
EKReminder
docs list only reminder-specific properties. Alarm support comes from inherited 
EKCalendarItem
behavior exposed by remindctl's 
--alarm
flag.

Complete / Delete

bash
remindctl complete 1 2 3          # Complete by ID
remindctl delete 4A83 --force     # Delete by ID

Output Formats

bash
remindctl today --json       # JSON for scripting
remindctl today --plain      # TSV format
remindctl today --quiet      # Counts only

Date Formats

Accepted by 
--due
and date filters:
  • today
    , 
    tomorrow
    , 
    yesterday
  • YYYY-MM-DD
  • YYYY-MM-DD HH:mm
  • ISO 8601 (
    2026-01-04T12:34:56Z
    )

Rules

  1. When user says "remind me", clarify: Apple Reminders (syncs to phone) vs agent cronjob alert
  2. Always confirm reminder content and due date before creating
  3. Use 
    --json
    for programmatic parsing