timely
by halbotley
DevOps & CloudBrief
Manage Apple Reminders from the command line with geofencing support.
Description
What This Skill Does
timely is a CLI tool for creating and viewing Apple Reminders on macOS. It supports location-based triggers (arrive/depart) and natural language due dates, operating silently through EventKit without opening the Reminders app.
Lets you create location-triggered reminders from scripts or terminal workflows without any GUI interaction.
When to Use It
- Set a reminder to buy groceries when arriving at a specific store
- Create a reminder to text someone when leaving the office
- Schedule a time-based reminder for a Friday deadline
- Add reminders to shared family iCloud lists by list name
Example Workflow
User asks: remind me to pick up my prescription when I arrive at CVS today
- 1
Run
timely liststo confirm the target list name - 2
Construct the add command with --due today, --location CVS, --address, and --arrive flags
- 3
Run
timely add Reminders "Pick up prescription" --due "today" --location "CVS" --address "789 Pharmacy Rd" --arrive - 4
Confirm reminder was created by running
timely show Reminders 5
Reminder appears in the Reminders app and triggers a notification when the user's device enters the geofence around the CVS address
Requirements
- macOS with Reminders access granted (System Settings → Privacy → Reminders)
Installation
clawhub install halbotley/timelyRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.