OpenParable
Skip to content
← Back to skills

Apple Reminders

Productivity
apple-reminders

Apple Reminders is an Agent Skill for productivity published in the elizaOS/eliza repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Manage Apple Reminders via the `remindctl` CLI on macOS (list, add, edit, complete, delete). Supports lists, date filters, and JSON/plain output. Use when the user asks about reminders, todos, tasks, to-do lists, "remind me", scheduling tasks, checking what is due today, completing or deleting reminders, or managing reminder lists on macOS.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/elizaOS/eliza/blob/HEAD/packages/skills/skills/apple-reminders/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/apple-reminders, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

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: bun install && bun run 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.