apple-reminders

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

Updated May 18, 2026
One-click install
npx skills add https://github.com/ossoolli/Nexum-Core --skill apple-reminders-ossoolli
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: apple-reminders
Source: https://github.com/ossoolli/Nexum-Core/tree/main/skills/apple/apple-reminders
Command: npx skills add https://github.com/ossoolli/Nexum-Core --skill apple-reminders-ossoolli

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 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 simple remindctl commands. - View and Filter Tasks: Query reminders by today, tomorrow, week, overdue, 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 the agent runs remindctl to create the reminder so it appears on their iPhone via iCloud sync. ## Quick Start Ask the agent to add a reminder with a due date, for example: create an Apple Reminder to buy milk 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 add with a title and optional flags, such as remindctl add --title "Call mom" --list Personal --due tomorrow. The reminder syncs to all Apple devices through iCloud once created.

How to list today's reminders in the macOS terminal?▼

Run remindctl today to show reminders due today, or use remindctl tomorrow, week, overdue, or a specific date like remindctl 2026-01-04. Add --json for machine-readable output.

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

Why does remindctl fail with a permission error?▼

remindctl needs macOS Reminders access granted to the terminal application. Check the current state with remindctl status and request authorization with remindctl authorize, then approve the system prompt.

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 means an automated agent alert, and clarify first if the intent is ambiguous.