apple-reminders

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

6|Updated Jul 12, 2026
One-click install
npx skills add https://github.com/josoroma/AppLoop --skill apple-reminders-josoroma
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: apple-reminders
Source: https://github.com/josoroma/AppLoop/tree/main/.hermes/skills/apple/apple-reminders
Command: npx skills add https://github.com/josoroma/AppLoop --skill apple-reminders-josoroma

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, alarms, and list assignments using natural date formats like "tomorrow" or ISO 8601 timestamps. - Query and filter tasks: View reminders for today, tomorrow, this week, overdue items, or specific dates, with JSON, TSV, or count-only 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 the dentist tomorrow at 9am" and the agent runs remindctl add --title "Call the dentist" --due "tomorrow 09:00", making the reminder appear on their iPhone via iCloud sync. ## Quick Start Ask the agent to add a reminder with a title and due date, for example: create a reminder to buy groceries tomorrow at 6 PM 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 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. It accepts dates like today, tomorrow, YYYY-MM-DD, or ISO 8601, and the reminder syncs to all Apple devices via iCloud.

How do I list today's reminders in the terminal on macOS?▼

Run remindctl today to see reminders due today, or use remindctl week, overdue, or all for other views. Add --json for machine-readable output, --plain for TSV, or --quiet for counts only.

What is the difference between --due and --alarm in remindctl?▼

The --due flag sets the reminder's actual due date and time, while --alarm sets the EventKit notification trigger time. Use --alarm when you want an earlier nudge, for example a reminder due at 2:00 PM with an alarm at 1:30 PM.

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. Install it via brew install steipete/tap/remindctl and grant Reminders permission when prompted.

When should I use Apple Reminders instead of an agent cronjob alert?▼

Use Apple Reminders when the user wants a personal to-do that syncs to their iPhone or iPad via iCloud. Use an agent cronjob when the user wants the agent itself to be alerted or to trigger an automated action at a scheduled time.