apple-reminders

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

Updated Jun 30, 2026
One-click install
npx skills add https://github.com/zhoulingxiao1216/testworkspace --skill apple-reminders-zhoulingxiao1216
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: apple-reminders
Source: https://github.com/zhoulingxiao1216/testworkspace/tree/main/all_Skills/apple/apple-reminders
Command: npx skills add https://github.com/zhoulingxiao1216/testworkspace --skill apple-reminders-zhoulingxiao1216

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing Apple Reminders normally requires opening the Reminders app on macOS, which interrupts terminal-based workflows. This Skill lets you create, list, complete, and delete reminders directly from the command line, with all tasks syncing across Apple devices via iCloud. ## Core Features & Use Cases - Create and manage reminders: Add reminders with titles, due dates, and list assignments using remindctl commands. - Query and filter tasks: View reminders for today, tomorrow, this week, overdue items, or specific dates, with JSON, TSV, or count-only output formats. - List management: Create, view, and delete Reminders lists to organize personal and work tasks. - Use Case: While working in the terminal, you remember you need to call a client tomorrow. Run a single remindctl add command with a due date, and the reminder appears on your iPhone via iCloud sync. ## Quick Start Ask the assistant to add a reminder to call mom tomorrow in your Personal list using Apple Reminders.

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 the remindctl add command with a title and optional due date, such as remindctl add --title "Call mom" --due tomorrow. Reminders sync 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 manually.

Can I get Apple Reminders output as JSON for scripting?▼

Yes, remindctl supports a --json flag on query commands like remindctl today --json for programmatic parsing. It also offers --plain for TSV output and --quiet for counts only.

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.

When should I use Apple Reminders instead of a cronjob alert?▼

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