Agent skill · writing content · steipete
reminders
Apple Reminders via rem CLI: add, list, search, update, complete, delete.
Why this skill is useful
Adds specific commands and usage patterns for the rem CLI that enhance task management capabilities on macOS.
What it needs
Requires go installed locally. About 2k tokens when loaded. Last updated 2026-08-06. 6,510 stars on the source repository.
What this skill does
Reminders Use this for Apple Reminders tasks. Prefer rem over Things/AppleScript when the user wants an AI-friendly personal todo backend on macOS. Tool CLI: rem Repo: https://github.com/BRO3886/rem Install: rem uses EventKit for normal reads/writes. It may need Reminders permission for the calling app in System Settings > Privacy & Security. Start Check access: Use JSON for anything scripted or verified: Add Tasks Default: add directly, then verify by search/show. Useful flags: --list "Name": target list --due "tomorrow 9am": due date/time; natural language is supported --priority high medium low none --notes "text" --url https://... --silent: due date without notification --remind-me 15m: alarm before due time --repeat daily weekly monthly yearly Update / Complete / Delete Find the UUID first, then mutate by id or unique short id: Always read back after writes; do not trust exit status alone. Lists Conventions Use executable task titles. Rewrite vague notes into the next concrete action. Preserve user wording when they clearly want verbatim capture. Split multiple unrelated actions into separate reminders. Use the default list unless the user names a list or the category is obvious. Do not add calendar events here; use calendar tooling instead. For current date math, run date; do not guess. Gotchas macOS only. First run may fail with reminders access denied until the calling app has Reminders permission. The default local list may be localized, e.g. Erinnerungen. rem search is plain query search, not shell regex. --due creates an alarm at the due time unless --silent is passed. Flagged reminders use private ReminderKit under the hood and may be more OS fragile than ordinary CRUD.
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills steipete/reminders