apple-reminders

Manage Apple Reminders lists and tasks via the remindctl command-line interface.

Updated Mar 7, 2026
One-click install
npx skills add https://github.com/shalevamin/Tau_agent --skill apple-reminders-shalevamin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: apple-reminders
Source: https://github.com/shalevamin/Tau_agent/tree/main/tau-agent-main/skills/apple-reminders
Command: npx skills add https://github.com/shalevamin/Tau_agent --skill apple-reminders-shalevamin

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires remindctl.

What problem does it solve? Managing Apple Reminders from the terminal is not natively supported, forcing users to switch to the GUI app for simple task operations. This Skill provides full command-line control over Apple Reminders so tasks can be created, viewed, completed, and deleted without leaving the terminal. ## Core Features & Use Cases - Reminder Management: Add, complete, edit, and delete reminders with due dates, priorities, and list assignments. - List Organization: Create, view, and delete reminder lists to organize personal and work tasks. - Date-Based Filtering: View reminders for today, tomorrow, this week, overdue items, or specific dates. - Scriptable Output: JSON, plain TSV, and quiet count modes for integration into scripts and automations. - Use Case: A user says "remind me to call mom tomorrow" and the agent runs remindctl add --title "Call mom" --due tomorrow, syncing the task to their iPhone automatically. ## Quick Start Ask the agent to add a reminder with a due date, for example: "Add a reminder to buy milk 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 with the add command, for example: remindctl add --title "Call mom" --list Personal --due tomorrow. It supports due dates in formats like today, tomorrow, YYYY-MM-DD, or ISO 8601.

How do I install remindctl on macOS?

Install remindctl via Homebrew with: brew install steipete/tap/remindctl. After installation, run remindctl authorize to grant Reminders access, and check the setup with remindctl status.

Does remindctl work on Linux or Windows?

No, remindctl is macOS-only because it integrates with the Apple Reminders framework. It requires macOS and explicit Reminders permission granted by the user.

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. These modes make it suitable for shell scripts and automation pipelines.

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

Use Apple Reminders when the task should sync to the user's iPhone or iPad Reminders app. For agent-triggered timed notifications or calendar events, use a cron-based alert or Apple Calendar instead.