apple-reminders

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

Updated May 29, 2026
One-click install
npx skills add https://github.com/Reimonsk8/hermes-9router-model-balancing --skill apple-reminders-reimonsk8
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: apple-reminders
Source: https://github.com/Reimonsk8/hermes-9router-model-balancing/tree/main/scripts/skills/apple/apple-reminders
Command: npx skills add https://github.com/Reimonsk8/hermes-9router-model-balancing --skill apple-reminders-reimonsk8

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, view, complete, and delete reminders directly from the command line, with tasks syncing across all Apple devices via iCloud. ## Core Features & Use Cases - Create and manage reminders: Add reminders with titles, due dates, and list assignments using remindctl commands. - View and filter tasks: List reminders for today, tomorrow, this week, overdue items, or specific dates, with JSON, TSV, or count-only output formats. - Organize lists: 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 via remindctl add --title "Call mom" --due tomorrow, and it syncs to iOS automatically. ## Quick Start Ask the assistant to add a reminder with a title and due date, for example: create an Apple Reminder to buy milk due tomorrow.

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 on macOS?▼

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?▼

Run remindctl today to show today's reminders, or use remindctl overdue, week, or a specific date like remindctl 2026-01-04. Add --json for machine-readable output or --quiet for counts only.

Does remindctl work on Linux or Windows?▼

No, remindctl only works on macOS because it integrates with the native Reminders.app and iCloud sync. Install it via brew install steipete/tap/remindctl and grant Reminders permission when prompted.

Why does remindctl fail with a permission error?▼

remindctl needs macOS Reminders permission to access your data. Run remindctl status to check authorization and remindctl authorize to request access, then approve the prompt in System Settings.

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

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