Reminders
Attribution: Sourced from steipete/agent-scripts by Peter Steinberger.
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
brew install BRO3886/tap/rem
Common Commands
# List all reminders
rem list
# List by list name
rem list "Work"
# Add reminder
rem add "Task title"
rem add "Task title" --list "Work"
rem add "Task title" --due "2025-12-31"
rem add "Task title" --note "Notes here"
# Search
rem search "search term"
# Complete
rem complete <reminder-id>
# Delete
rem delete <reminder-id>
# Show lists
rem lists
Notes
- Requires macOS with Apple Reminders app.
remcommunicates with Reminders via EventKit.- Due dates use ISO format:
YYYY-MM-DDorYYYY-MM-DD HH:MM. - Reminder IDs are unique identifiers from EventKit.