reminders

Read, create, edit, and manage Apple Reminders through the RemCTL CLI on macOS.

3|Updated Nov 8, 2014
One-click install
npx skills add https://github.com/mintuz/.dotfiles --skill reminders-mintuz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reminders
Source: https://github.com/mintuz/.dotfiles/tree/main/agents/.agents/skills/reminders
Command: npx skills add https://github.com/mintuz/.dotfiles --skill reminders-mintuz

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing Apple Reminders from the command line or an AI agent is difficult because EventKit only exposes a subset of Reminders features, and direct database writes are unsafe. This Skill teaches agents how to use the RemCTL CLI to read, create, edit, complete, and troubleshoot reminders with full fidelity, including private metadata like tags, sections, smart lists, and templates. ## Core Features & Use Cases - Full Reminders CRUD: Read due items, lists, groups, and reminders with JSON output, and create or edit reminders with due dates, recurrence, priorities, and alarms through EventKit. - Private Metadata Writes: Use explicit --private commands for synced tags, rich links, sections, subtasks, images, flagging, list groups, custom smart lists, Groceries lists, and Reminders templates. - Safe Automation Guardrails: Destructive commands require --force, private rich URLs are validated, and every write has a documented JSON verification path. - Use Case: Ask your agent to create a recurring weekly report reminder in your Work list with a 15-minute alarm, then verify it with remctl info <id> --json. ## Quick Start Ask the agent to show today's reminders as JSON using the remctl today command, then create a new reminder with a due date in a chosen list.

Frequently Asked Questions about reminders

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create an Apple Reminder from the command line on macOS?

Use remctl add with a title, list, and due date, for example remctl add "Review PR" -l Work -d "tomorrow 10:00" -p high --json. Date-only inputs create all-day reminders, and explicit times create timed reminders.

How do I add tags or sections to an Apple Reminder via CLI?

Tags, sections, rich links, subtasks, and images require the --private flag because they use unsupported ReminderKit APIs. Use remctl edit <id> --private --set-tags or section-create, then verify with remctl info <id> --json.

Can I create recurring reminders with remctl?

Yes, recurrence is a normal EventKit write and does not need --private. Supported forms include daily, weekly mon,wed,fri, monthly 4th-fri, and yearly, with optional intervals like daily x2, verified via the recurrence object in JSON output.

Why does remctl return confirmation_required on delete?

Destructive commands like delete, list-delete, and group-delete require --force in agent or JSON workflows. Without it, RemCTL writes confirmation_required to stderr and performs no write, so always pass --force for automation.

What is the --via-eventkit fallback in remctl and when should I use it?

It is a limited read-only fallback for show, search, today, and upcoming when Full Disk Access blocks database reads. It returns eventKitId values instead of numeric IDs and lacks tags, sections, and private metadata, so prefer fixing Full Disk Access.

How do I flag or unflag an Apple Reminder from the terminal?

Use remctl flag <id> --json or unflag, which writes the real flagged state through AppleScript and requires Automation access for Reminders. If that fails, fall back to remctl edit <id> --private --flagged and verify under flagged in info --json.