List, add, edit, complete, or delete Apple Reminders and reminder lists via remindctl.
The Apple Reminders skill provides a command-line interface for managing Apple Reminders directly from macOS terminals. By leveraging the `remindctl` tool, users can list, add, edit, complete, and delete reminders and reminder lists without manually opening the Reminders app. This skill streamlines personal task management by offering a terminal-based workflow, allowing users to interact with their reminders quickly and efficiently. It addresses the need for syncing tasks across Apple devices while enabling automation or scripting of reminder management.
The skill's main features include viewing reminders for specific dates or ranges, managing multiple reminder lists, creating new reminders with optional titles, due dates, and lists, and completing or deleting reminders by ID. Users can also choose different output formats, including JSON, TSV, or count-only summaries, to suit scripting or reporting needs. The skill supports a variety of date formats, including natural language keywords like 'today' or 'tomorrow,' specific dates in `YYYY-MM-DD` or `YYYY-MM-DD HH:mm` formats, and ISO 8601 timestamps.
Typical use cases for this skill include managing personal to-do lists that sync to iPhone or iPad devices, organizing reminders by project or category, and automating routine reminder tasks via the terminal. It is particularly suited for macOS users who prefer terminal workflows and require reminders that integrate seamlessly with Apple's ecosystem. Target users include developers, power users, or anyone looking to efficiently manage Apple Reminders programmatically or through scripts.
This skill is macOS-only as it relies on Apple's Reminders system and the `remindctl` CLI.
Install `remindctl` via Homebrew using `brew install steipete/tap/remindctl`. After installation, grant the app permission to access Reminders when prompted.
Yes, you can view reminders for today, tomorrow, past due, or a specific date using commands like `remindctl today`, `remindctl overdue`, or `remindctl YYYY-MM-DD`.
The skill supports JSON and TSV output formats, allowing easy parsing for automation or scripting purposes.
This skill is intended for personal reminders and task lists. It is not recommended for calendar events, one-time alerts, or project/work task management outside of Apple Reminders.
Quick Setup:
.claude/skills/Repository
steipete/clawdis