apple-reminders

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

1|Updated Jun 24, 2026
One-click install
npx skills add https://github.com/maopujie10-sys/Bailongma --skill apple-reminders-maopujie10-sys
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: apple-reminders
Source: https://github.com/maopujie10-sys/Bailongma/tree/main/skills/hermes-skills/apple/apple-reminders
Command: npx skills add https://github.com/maopujie10-sys/Bailongma --skill apple-reminders-maopujie10-sys

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 via remindctl, with tasks syncing across all Apple devices through iCloud. ## Core Features & Use Cases - Create and schedule reminders: Add reminders with titles, lists, due dates, and separate alarm times for early notifications. - Query and organize: View reminders for today, tomorrow, this week, or overdue items, and manage multiple reminder lists. - Scriptable output: Use JSON, TSV, or quiet output modes for programmatic parsing in automation pipelines. - Use Case: A user says "remind me to call the dentist tomorrow at 9am" and the agent creates an Apple Reminder that syncs to their iPhone, with an optional alarm set 30 minutes before the due time. ## Quick Start Ask the agent to add a reminder such as "add a reminder to buy milk tomorrow at 6pm using Apple Reminders" and it will run the appropriate remindctl command.

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, 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 set an early notification for a reminder on macOS?

Pass both --due and --alarm to remindctl. The --due flag sets the actual due time while --alarm sets when the notification fires, so you can get alerted 30 minutes before the due time.

Does remindctl work on Linux or Windows?

No, remindctl only works on macOS because it relies on Apple's EventKit framework and the Reminders app. Install it via brew install steipete/tap/remindctl and grant Reminders permission when prompted.

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

The Reminders UI may group items by alarm time rather than due time. Verify the actual values with remindctl today --json, which shows dueDate and alarmDate as separate fields.

When should I use Apple Reminders instead of a cron job?

Use Apple Reminders for personal to-dos that should sync to your iPhone or iPad. Use a cronjob or agent alert for scheduled agent actions, and calendar tools for events rather than tasks.