apple-reminders

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

Updated Jul 10, 2026
One-click install
npx skills add https://github.com/AvaTar-ArTs/.Agent-skills --skill apple-reminders-avatar-arts
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: apple-reminders
Source: https://github.com/AvaTar-ArTs/.Agent-skills/tree/main/skills/apple/apple-reminders
Command: npx skills add https://github.com/AvaTar-ArTs/.Agent-skills --skill apple-reminders-avatar-arts

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, with tasks syncing across all Apple devices via iCloud. ## Core Features & Use Cases - Create and manage reminders: Add reminders with titles, due dates, 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 confirms the details, then runs remindctl to create the reminder in the Personal list, syncing it to all Apple devices. ## Quick Start Ask the assistant to add a reminder with a title and due date to Apple Reminders, for example to create a reminder to buy milk due tomorrow. Note: requires macOS with remindctl installed via brew install steipete/tap/remindctl and Reminders permission granted.

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, grant Reminders permission when prompted, or run remindctl authorize to request access.

What date formats does remindctl accept for due dates?

remindctl accepts relative dates like today, tomorrow, and yesterday, plus YYYY-MM-DD, YYYY-MM-DD HH:mm, and ISO 8601 formats such as 2026-01-04T12:34:56Z for the --due flag and date filters.

Can I get Apple Reminders output as JSON for scripting?

Yes, pass the --json flag to commands like remindctl today --json to get structured JSON output. The --plain flag produces TSV and --quiet returns counts only.

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 via iCloud. Use a cronjob or agent alert when the user means a scheduled agent notification rather than a Reminders app task.