apple-reminders

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

Updated Aug 21, 2026
One-click install
npx skills add https://github.com/TylerSimons1127/vibe --skill apple-reminders-tylersimons1127
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: apple-reminders
Source: https://github.com/TylerSimons1127/vibe/tree/main/skills/apple/apple-reminders
Command: npx skills add https://github.com/TylerSimons1127/vibe --skill apple-reminders-tylersimons1127

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 - Reminder Creation: Add reminders with titles, lists, due dates, and separate alarm times for early notifications. - Viewing & Filtering: View reminders for today, tomorrow, this week, overdue items, or specific dates, with JSON, TSV, or count-only output formats. - 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 a due date, and it syncs to iOS through iCloud automatically. ## Quick Start Ask the agent to add a reminder such as "add a reminder to buy milk tomorrow" and it will run the appropriate remindctl command after confirming the details.

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 the remindctl CLI with the add command, for example remindctl add --title "Call mom" --list Personal --due tomorrow. Install it first with brew install steipete/tap/remindctl and grant Reminders permission when prompted.

How to set an early notification alarm for an Apple Reminder?▼

Pass the --alarm flag separately from --due when creating or editing a reminder. For example, remindctl add --title "Hairdresser" --due "2026-05-15 14:00" --alarm "2026-05-15 13:30" notifies 30 minutes before the due time.

Does remindctl sync reminders to iPhone and iPad?▼

Yes, reminders created with remindctl sync across all Apple devices through iCloud, since it writes directly to Apple Reminders via EventKit. Tasks appear in the Reminders app on iOS and iPadOS automatically.

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

Use Apple Reminders for personal to-dos that should appear on your iPhone or iPad with due dates. Use an agent cronjob instead when you want the agent itself to trigger an alert or scheduled action.

Why does my reminder show the wrong time in the Reminders app?▼

The Reminders UI may group or display items by the alarm time rather than the due time, since that is when the notification fires. Verify the actual values with remindctl today --json, which shows dueDate and alarmDate separately.