apple-reminders

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

2|Updated Oct 20, 2017
One-click install
npx skills add https://github.com/rbudiharso/dotfiles --skill apple-reminders-rbudiharso
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: apple-reminders
Source: https://github.com/rbudiharso/dotfiles/tree/main/hermes/.hermes/skills/apple/apple-reminders
Command: npx skills add https://github.com/rbudiharso/dotfiles --skill apple-reminders-rbudiharso

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 due dates, alarms, and list assignments using remindctl commands. - View and filter tasks: Show today's, tomorrow's, overdue, or date-specific reminders, 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 with a due date via remindctl, and it syncs to iOS through iCloud. ## Quick Start Use the apple-reminders skill to add a reminder titled "Buy milk" due tomorrow to 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 with the add command, 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.

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

The --due flag sets the reminder's actual due date and time, while --alarm sets the notification trigger time. Pass --alarm explicitly when you want an earlier nudge than the due time, and verify with remindctl today --json.

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

Yes, remindctl supports --json for structured output, --plain for TSV format, and --quiet for counts only. Use --json when parsing reminder data programmatically in scripts.

When should I not use Apple Reminders for reminders?▼

Avoid Apple Reminders for scheduling agent alerts, which belong in a cronjob tool, and for calendar events, which belong in Apple or Google Calendar. Project task management is better handled by GitHub Issues or Notion.