/apple-reminders

description: Manage Apple Reminders via remindctl CLI (list, add, complete, delete).
version: 1.0.0
license: MIT
platforms:
- macos
metadata:
  catalog:
    tags:
    - Reminders
    - tasks
    - todo
    - macOS
    - Apple
prerequisites:
  commands:
  - remindctl

Kheish Compatibility

This skill is repo-local and stays inactive until explicitly activated.

When the original instructions refer to legacy tool names, use these Kheish mappings:

• `terminal` => `bash`
• `web_extract` => `web_fetch`, plus `web_search` when discovery is needed
• `search_files` => `grep_search` and `glob_search`
• `browser_*` tools require a browser-capable surfaced tool or MCP; if none is available, use the closest available surface and say so explicitly

When the instructions mention local helper files, resolve them from `${KHEISH_SKILL_DIR}`.

Apple Reminders

Use `remindctl` to manage Apple Reminders directly from the terminal. Tasks sync across all Apple devices via iCloud.

Prerequisites

• **macOS** with Reminders.app
• Install: `brew install steipete/tap/remindctl`
• Grant Reminders permission when prompted
• Check: `remindctl status` / Request: `remindctl authorize`

When to Use

• User 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 on their iPhone/iPad

When NOT to Use

• Scheduling agent alerts → use the cronjob tool instead
• Calendar events → use Apple Calendar or Google Calendar
• Project task management → use GitHub Issues, Notion, etc.
• If user says "remind me" but means an agent alert → clarify first

Quick Reference

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`)

Rules

1. When user says "remind me", clarify: Apple Reminders (syncs to phone) vs agent cronjob alert 2. Always confirm reminder content and due date before creating 3. Use `--json` for programmatic parsing