apple-reminders

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

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

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 - Create and manage reminders: Add reminders with titles, due dates, and list assignments using remindctl commands. - View and filter tasks: Show today's, tomorrow's, overdue, or date-specific reminders, with JSON, plain, or quiet output formats 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 mom tomorrow" and wants it on their iPhone. The Skill creates the reminder via remindctl with the correct due date, and it syncs to all their Apple devices through iCloud. ## 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 an Apple Reminder from the command line?▼

Use remindctl add with a title, for example: remindctl add --title "Call mom" --list Personal --due tomorrow. The reminder syncs to all Apple devices via iCloud once created.

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

Run remindctl today to show reminders due today, or remindctl overdue for past-due items. Add --json for machine-readable output or --plain for TSV format suitable for scripting.

What date formats does remindctl accept for due dates?▼

remindctl accepts relative dates like today, tomorrow, and yesterday, plus YYYY-MM-DD, YYYY-MM-DD HH:mm, and full ISO 8601 timestamps such as 2026-01-04T12:34:56Z.

Does remindctl work on Linux or Windows?▼

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

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

Use Apple Reminders for personal to-dos that should sync to iPhone or iPad. Use a cronjob for scheduled agent alerts, and a calendar app for time-blocked events or meetings.