---
name: hacklyc-apple-reminders
description: "Manage Apple Reminders via the `remindctl` CLI on macOS (list, add, edit, complete, delete). Supports lists, date filters, and JSON/plain output."
license: "AGPL-3.0"
metadata:
  decimalai-skill-id: "e1bf578f-89e1-413d-b962-aec4c0e58c5f"
  decimalai-version-id: "547562da-fbe2-42d8-bacb-00265128557d"
  decimalai-version: "1"
  decimalai-body-sha256: "48fb5bcc452a0c1b72c03b46fbade6841c38dfd8be98367182f6f41368c0ab6f"
  decimalai-name: "hacklyc/apple-reminders"
  decimalai-format: "1"
  decimalai-invocation: "model"
  decimalai-category: "productivity"
  decimalai-source: "https://app.decimal.ai/s/hacklyc-apple-reminders@1/SKILL.md"
---
# Apple Reminders CLI (remindctl)

Use `remindctl` to manage Apple Reminders directly from the terminal. It supports list filtering, date-based views, and scripting output.

Setup

- Install (Homebrew): `brew install steipete/tap/remindctl`
- From source: `pnpm install && pnpm build` (binary at `./bin/remindctl`)
- macOS-only; grant Reminders permission when prompted.

Permissions

- Check status: `remindctl status`
- Request access: `remindctl authorize`

View Reminders

- Default (today): `remindctl`
- Today: `remindctl today`
- Tomorrow: `remindctl tomorrow`
- Week: `remindctl week`
- Overdue: `remindctl overdue`
- Upcoming: `remindctl upcoming`
- Completed: `remindctl completed`
- All: `remindctl all`
- Specific date: `remindctl 2026-01-04`

Manage Lists

- List all lists: `remindctl list`
- Show list: `remindctl list Work`
- Create list: `remindctl list Projects --create`
- Rename list: `remindctl list Work --rename Office`
- Delete list: `remindctl list Work --delete`

Create Reminders

- Quick add: `remindctl add "Buy milk"`
- With list + due: `remindctl add --title "Call mom" --list Personal --due tomorrow`

Edit Reminders

- Edit title/due: `remindctl edit 1 --title "New title" --due 2026-01-04`

Complete Reminders

- Complete by id: `remindctl complete 1 2 3`

Delete Reminders

- Delete by id: `remindctl delete 4A83 --force`

Output Formats

- JSON (scripting): `remindctl today --json`
- Plain TSV: `remindctl today --plain`
- Counts only: `remindctl today --quiet`

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

Notes

- macOS-only.
- If access is denied, enable Terminal/remindctl in System Settings > Privacy & Security > Reminders.
- If running over SSH, grant access on the Mac that runs the command.