apple-reminders

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

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

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, and organize them into custom lists. - Scriptable output: Use --json, --plain, or --quiet output formats for programmatic parsing and automation. - Use Case: A user says "remind me to call mom tomorrow" and wants it on their iPhone. The Skill creates the reminder via remindctl with a due date, and it syncs to iOS 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 in my Personal list.

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 your Apple devices via iCloud once created.

How do I install remindctl on macOS?

Install remindctl via Homebrew with brew install steipete/tap/remindctl. After installation, run remindctl status to check permissions and remindctl authorize to request Reminders 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 use remindctl output in scripts?

Yes, remindctl supports machine-readable output formats. Use --json for structured JSON parsing, --plain for TSV output, or --quiet to get counts only, making it suitable for shell scripting and automation.

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

Use Apple Reminders when you want a personal to-do that syncs to your iPhone or iPad via iCloud. Use a cronjob or agent alert when you need the assistant itself to notify you or run a scheduled action.