apple-reminders

Manage Apple Reminders from the terminal using the remindctl CLI on macOS.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing personal to-dos in Apple Reminders normally requires opening the Reminders app, which breaks terminal-based workflows. This Skill lets you create, list, complete, and delete reminders directly from the command line, with everything syncing to iPhone and iPad 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 today's, tomorrow's, overdue, or date-specific reminders, with JSON, TSV, or count-only output for scripting. - List management: Create, view, and delete Reminders lists to organize tasks by project or context. - Use Case: A user says "remind me to call the dentist tomorrow at 9am" — the Skill runs remindctl add with the correct due date, and the reminder appears on all their Apple devices. ## Quick Start Ask the assistant to add a reminder with a title and due date, for example: create an Apple 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 add an Apple Reminder from the command line?▼

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

How do I install remindctl on macOS?▼

Install remindctl via Homebrew with brew install steipete/tap/remindctl. After installation, run remindctl status to check permissions and remindctl authorize to request Reminders access if needed.

What is the difference between due date and alarm in Apple Reminders?▼

The --due flag sets when the reminder is due, while --alarm sets when the notification fires. Pass --alarm explicitly when you want an earlier nudge, such as an alert 30 minutes before the due time.

Can I get Apple Reminders output as JSON for scripting?▼

Yes, append --json to any remindctl query such as remindctl today --json to get structured output with fields like dueDate and alarmDate. Use --plain for TSV or --quiet for counts only.

When should I not use Apple Reminders for a reminder request?▼

Avoid Apple Reminders for scheduling agent alerts (use a cronjob tool instead), calendar events (use a calendar app), or project task management (use GitHub Issues or Notion). Clarify first if "remind me" means an agent alert.