apple-reminders

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

Updated Jul 7, 2026
One-click install
npx skills add https://github.com/jamsdoescode/Erik-s-Portfolio --skill apple-reminders-jamsdoescode
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: apple-reminders
Source: https://github.com/jamsdoescode/Erik-s-Portfolio/tree/main/openclicky/AppResources/OpenClicky/OpenClickyBundledSkills/apple-reminders
Command: npx skills add https://github.com/jamsdoescode/Erik-s-Portfolio --skill apple-reminders-jamsdoescode

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing Apple Reminders normally requires opening the Reminders app on macOS, which interrupts terminal-based and AI-assisted 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 tasks with due dates using natural formats like "tomorrow" or ISO 8601 timestamps, and assign them to specific lists. - View and filter reminders: Show today's, tomorrow's, overdue, or date-specific reminders, with JSON, TSV, or count-only output for scripting. - Manage lists and completion: Create or delete reminder lists and mark items complete or remove them by ID. - Use Case: A user says "remind me to call mom tomorrow" and the assistant creates an Apple Reminder that syncs to their iPhone, after clarifying they want a device reminder rather than an agent cronjob alert. ## Quick Start Ask the assistant to add a reminder such as "remind me to buy milk tomorrow" and it will create the task in Apple Reminders via 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 an Apple Reminder from the command line?

Use remindctl add followed by the reminder title, for example remindctl add "Buy milk". You can set a list and due date with flags like --list Personal and --due tomorrow or a YYYY-MM-DD date.

How do I install remindctl on macOS?

Install remindctl with Homebrew by running brew install steipete/tap/remindctl. After installation, run remindctl status to check authorization and remindctl authorize to request Reminders permission.

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 full ISO 8601 timestamps 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 tool also supports --plain for TSV format and --quiet for counts only.

When should I use Apple Reminders instead of a cronjob or calendar?

Use Apple Reminders for personal to-dos that should sync to iOS devices via iCloud. Use a cronjob tool for agent alerts, calendar apps for events, and project trackers like GitHub Issues for team task management.