A CLI for Apple Reminders with geofencing support.
- Time-based reminders — due dates with natural language ("tomorrow 3pm")
- Location-based reminders — geofencing with arrive/depart triggers
- Address geocoding — use street addresses, not just coordinates
- List management, priorities, notes, URLs
# Build from source
git clone https://github.com/halbotley/timely.git
cd timely
swift build -c release
cp .build/release/timely /usr/local/bin/# List reminder lists
timely list
# Show reminders in a list
timely show Reminders
# Time-based reminder
timely add Reminders "Call mom" --due "tomorrow 3pm"
# Location-based reminder (geofence)
timely add Reminders "Get gas" --location "Costco" --address "7095 Marketplace Dr, Goleta, CA"
timely add Reminders "Take out trash" --location "Home" --lat 34.4208 --lon -119.6982 --arrive
# With departure trigger
timely add Reminders "Lock up" --location "Office" --address "123 Main St" --depart
# Complete a reminder
timely complete Reminders "Call mom"
# Delete a reminder
timely delete Reminders "Get gas"| Option | Description |
|---|---|
--due <datetime> |
Due date (e.g., "tomorrow 3pm", "2026-02-15 14:00") |
--priority <1-3> |
Priority (1=high, 2=medium, 3=low) |
--notes <text> |
Add notes |
--url <url> |
Attach a URL |
--location <name> |
Location name for geofence |
--address <addr> |
Street address to geocode |
--lat <lat> |
Latitude (use with --lon) |
--lon <lon> |
Longitude (use with --lat) |
--radius <meters> |
Geofence radius (default: 100) |
--arrive |
Trigger on arrival (default) |
--depart |
Trigger on departure |
- macOS 13.0+
- Reminders access (System Settings > Privacy & Security > Reminders)
MIT