MH apple-reminders

Manage Apple Reminders via remindctl CLI (list, add, edit, complete, delete). Supports lists, date filters, and JSON/plain output.

Security Scan

The skill is internally consistent: it wraps the remindctl CLI for macOS Reminders, asks for no unrelated credentials, and its Homebrew install is appropriate — review the third‑party tap before installing.

Purpose & Capability

Name/description, required binary (remindctl), macOS restriction, and Homebrew formula (steipete/tap/remindctl) all align with the stated purpose of managing Apple Reminders.

Instruction Scope

SKILL.md only documents using remindctl commands, checking status, and requesting Reminders permission. It does not instruct reading unrelated files, sending data to external endpoints, or accessing other credentials.

Install Mechanism

Install uses a Homebrew formula from the steipete/tap tap (GitHub-hosted tap is common), which is reasonable. This is a third‑party tap — users should verify the formula/repo before installing to ensure trustworthiness.

Credentials

The skill requests no environment variables, no config paths, and no credentials. The only runtime permission of note is granting Reminders access to the remindctl binary, which is necessary for the stated functionality.

Persistence & Privilege

always is false and the skill does not request persistent elevated privileges or modify other skills. Default autonomous invocation is allowed (platform default) but not excessive for this tool.

Assessment

This skill is coherent for its purpose. Before installing: (1) confirm you are on macOS and comfortable granting the remindctl binary access to your Reminders (it will read and modify your personal reminders); (2) review the Homebrew tap/repo (https://github.com/steipete/remindctl and the steipete/tap formula) to ensure you trust the source; (3) if you do not want an autonomous agent to run the tool without prompting, restrict skill invocation in your agent settings. No environment secrets are requested by the skill.

Apple Reminders CLI (remindctl)

Use remindctl to manage Apple Reminders directly from the terminal.

When to Use

✅ USE this skill when:

• User explicitly mentions "reminder" or "Reminders app"
• Creating personal to-dos with due dates that sync to iOS
• Managing Apple Reminders lists
• User wants tasks to appear in their iPhone/iPad Reminders app

When NOT to Use

❌ DON'T use this skill when:

• Scheduling Clawdbot tasks or alerts → use cron tool with systemEvent instead
• Calendar events or appointments → use Apple Calendar
• Project/work task management → use Notion, GitHub Issues, or task queue
• One-time notifications → use cron tool for timed alerts
• User says "remind me" but means a Clawdbot alert → clarify first

Setup

• Install: brew install steipete/tap/remindctl
• macOS-only; grant Reminders permission when prompted
• Check status: remindctl status
• Request access: remindctl authorize

Common Commands

View Reminders

remindctl                    # Today's reminders
remindctl today              # Today
remindctl tomorrow           # Tomorrow
remindctl week               # This week
remindctl overdue            # Past due
remindctl all                # Everything
remindctl 2026-01-04         # Specific date

Manage Lists

remindctl list               # List all lists
remindctl list Work          # Show specific list
remindctl list Projects --create    # Create list
remindctl list Work --delete        # Delete list

Create Reminders

remindctl add "Buy milk"
remindctl add --title "Call mom" --list Personal --due tomorrow
remindctl add --title "Meeting prep" --due "2026-02-15 09:00"

Complete/Delete

remindctl complete 1 2 3     # Complete by ID
remindctl delete 4A83 --force  # Delete by ID

Output Formats

remindctl today --json       # JSON for scripting
remindctl today --plain      # TSV format
remindctl today --quiet      # Counts only

Date Formats

Accepted by --due and date filters:

• today, tomorrow, yesterday
• YYYY-MM-DD
• YYYY-MM-DD HH:mm
• ISO 8601 (2026-01-04T12:34:56Z)

Example: Clarifying User Intent

User: "Remind me to check on the deploy in 2 hours"

Ask: "Do you want this in Apple Reminders (syncs to your phone) or as a Clawdbot alert (I'll message you here)?"

• Apple Reminders → use this skill
• Clawdbot alert → use cron tool with systemEvent