apple-reminders

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

Updated Jun 7, 2026
One-click install
npx skills add https://github.com/Chensihakniroth/ANAKOT-AGENT --skill apple-reminders-chensihakniroth
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: apple-reminders
Source: https://github.com/Chensihakniroth/ANAKOT-AGENT/tree/main/skills/apple/apple-reminders
Command: npx skills add https://github.com/Chensihakniroth/ANAKOT-AGENT --skill apple-reminders-chensihakniroth

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing Apple Reminders normally requires opening the Reminders app on macOS, which breaks terminal-based and agent-driven 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 and Scheduling: Add reminders with due dates, alarms, and list assignments using natural date formats like "tomorrow" or ISO 8601 timestamps. - List and Task Management: View today's, tomorrow's, or overdue reminders, create and delete lists, and complete or remove tasks by ID. - Scriptable Output: Use JSON, TSV, or quiet output modes for programmatic parsing in automation pipelines. - Use Case: A user says "remind me to call mom tomorrow at 5pm on my iPhone" — the agent runs remindctl to create the reminder in the Personal list, and it syncs to iOS via iCloud. ## Quick Start Ask the agent to add a reminder such as "Remind me to buy milk tomorrow" and it will create the task in Apple Reminders using remindctl.

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. It accepts natural dates like today or tomorrow, YYYY-MM-DD, and ISO 8601 formats.

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 Apple Reminders?▼

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

Does remindctl work on Windows or Linux?▼

No, remindctl only works on macOS because it relies on Apple's EventKit framework and the Reminders app. Tasks created with it sync to other Apple devices through iCloud.

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 wants the agent itself to trigger an alert or scheduled action.