ekkolearnai Apple Reminders
Use remindctl when the user wants tasks stored in Apple Reminders and synchronized through their Apple account. This Skill is macOS-only.
If “remind me” could mean either an Apple Reminder or a notification inside the current host application, ask which destination they want when the surrounding context does not make it clear. Do not claim that this Skill schedules chat messages or agent jobs.
Prerequisites
command -v remindctl
remindctl status
The remindctl CLI comes from https://github.com/steipete/remindctl. If it is missing, explain the dependency and let the user decide whether to install it; do not install it silently.
The user may need to grant Reminders access:
remindctl authorize
Authorization is a visible macOS permission decision. Let the user approve or deny it.
View reminders
remindctl
remindctl today
remindctl tomorrow
remindctl week
remindctl overdue
remindctl all
remindctl 2026-01-04
remindctl today --json
remindctl today --plain
remindctl today --quiet
Prefer JSON for structured processing. Limit the returned personal data to what is needed for the request.
Manage lists
remindctl list
remindctl list Work
remindctl list Projects --create
remindctl list Work --delete
Creating or deleting a list changes the user's Reminders library. Verify the exact list name; confirm before deleting a list unless the user explicitly named that deletion.
Create reminders
remindctl add "Buy milk"
remindctl add --title "Call mom" --list Personal --due tomorrow
remindctl add --title "Meeting prep" --due "2026-02-15 09:00"
Resolve relative dates in the user's local timezone. Before creation, make sure the title, list, due date and time, and timezone are unambiguous. Do not invent a due time for a date-only request.
Complete and delete
remindctl complete 1 2 3
remindctl delete 4A83 --force
First list or otherwise resolve each ID to its title and list. Completing and deleting are mutations; perform them only when the user requested them. Confirm immediately before a forced deletion if the exact target was not already explicit.
Date formats
--due and date filters accept today, tomorrow, yesterday, YYYY-MM-DD, YYYY-MM-DD HH:mm, and ISO 8601 timestamps. Use absolute dates in the final response when a relative date could be misunderstood.