apple-reminders

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

Updated Sep 9, 2026
One-click install
npx skills add https://github.com/luckybbjason1/trading --skill apple-reminders-luckybbjason1
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: apple-reminders
Source: https://github.com/luckybbjason1/trading/tree/main/.hermes/skills/apple/apple-reminders
Command: npx skills add https://github.com/luckybbjason1/trading --skill apple-reminders-luckybbjason1

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing Apple Reminders normally requires opening the Reminders app on macOS, which breaks terminal-based workflows. This Skill lets you create, list, complete, and delete reminders directly from the command line via remindctl, with all tasks syncing across Apple devices through iCloud. ## Core Features & Use Cases - Reminder Management: Add reminders with due dates, alarms, and list assignments, then complete or delete them by ID. - Flexible Views: Query reminders for today, tomorrow, this week, overdue items, or specific dates, with JSON, TSV, or count-only output formats. - List Organization: Create, view, and delete reminder 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 all their Apple devices through iCloud. ## Quick Start Ask the assistant to add a reminder with a title and due date, for example: create an Apple Reminder to buy milk due tomorrow.

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, such as 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, grant Reminders permission when prompted, or check status with remindctl status and request access with remindctl authorize.

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 EventKit notification trigger. Pass --alarm explicitly when you want an earlier notification than the due time, and verify both fields with remindctl today --json.

Can I get Apple Reminders output as JSON for scripting?

Yes, remindctl supports --json for structured JSON output, --plain for TSV format, and --quiet for counts only. Use the JSON flag 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 a calendar app. It is also not suited for project task management handled by tools like GitHub Issues or Notion.