\r \r

Apple Remind Me (macOS Native)\r

\r Create, manage, and organize Apple Reminders using natural language. Works with Reminders.app natively - syncs to iPhone, iPad, Apple Watch.\r \r

Quick Reference\r

\r | Want to... | Command | Example |\r |-----------|---------|---------|\r | Create reminder | create-reminder.sh "msg" "when" | create-reminder.sh "Call mom" "tomorrow at 2pm" |\r | List reminders | list-reminders.sh [filter] | list-reminders.sh today |\r | Complete reminder | complete-reminder.sh ID | complete-reminder.sh XXXX-XXXX |\r | Delete reminder | delete-reminder.sh ID | delete-reminder.sh XXXX-XXXX |\r | Edit message | edit-reminder-message.sh ID "msg" | edit-reminder-message.sh XXXX "New text" |\r | Edit time | edit-reminder-time.sh ID "when" | edit-reminder-time.sh XXXX "next friday" |\r \r

Available Commands\r

\r

1. Create Reminder\r

Create a new reminder with natural language time parsing.\r \r Usage:\r

./create-reminder.sh "message" "when"\r
```\r
\r
**Examples:**\r
```bash\r
./create-reminder.sh "Pay bills" "later today"\r
./create-reminder.sh "Call dentist" "tomorrow at 3pm"\r
./create-reminder.sh "Check email" "in 2 hours"\r
./create-reminder.sh "Team meeting" "next monday at 10am"\r
```\r
\r
### 2. List Reminders\r
Display all incomplete reminders with IDs, titles, due dates, and lists.\r
\r
**Usage:**\r
```bash\r
./list-reminders.sh\r
```\r
\r
**Output Format:**\r
```\r
⏳ ID: XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX\r
   Title: Reminder text\r
   Due: 2026-01-27 14:00\r
   List: Reminders\r
```\r
\r
### 3. Complete Reminder\r
Mark a reminder as completed (it will move to completed list in Reminders.app).\r
\r
**Usage:**\r
```bash\r
./complete-reminder.sh "REMINDER-ID"\r
```\r
\r
**Example:**\r
```bash\r
./complete-reminder.sh "CDCBCB94-1215-494E-9F12-471AFEF25C09"\r
```\r
\r
### 4. Delete Reminder\r
Permanently delete a reminder.\r
\r
**Usage:**\r
```bash\r
./delete-reminder.sh "REMINDER-ID"\r
```\r
\r
**Example:**\r
```bash\r
./delete-reminder.sh "7C403BC5-6016-410A-810D-9A0F924682F9"\r
```\r
\r
### 5. Edit Reminder Message\r
Update the text/title of an existing reminder.\r
\r
**Usage:**\r
```bash\r
./edit-reminder-message.sh "REMINDER-ID" "new message"\r
```\r
\r
**Example:**\r
```bash\r
./edit-reminder-message.sh "CDCBCB94-1215-494E-9F12-471AFEF25C09" "Updated reminder text"\r
```\r
\r
### 6. Edit Reminder Time\r
Reschedule a reminder to a new time using natural language.\r
\r
**Usage:**\r
```bash\r
./edit-reminder-time.sh "REMINDER-ID" "new time"\r
```\r
\r
**Examples:**\r
```bash\r
./edit-reminder-time.sh "CDCBCB94-1215-494E-9F12-471AFEF25C09" "tomorrow at 2pm"\r
./edit-reminder-time.sh "CDCBCB94-1215-494E-9F12-471AFEF25C09" "in 3 hours"\r
./edit-reminder-time.sh "CDCBCB94-1215-494E-9F12-471AFEF25C09" "next friday"\r
```\r
\r
## Time Parsing Reference\r
\r
### Relative Times\r
Format: `in [number] [unit]`\r
- `in 5 minutes` → 5 minutes from now\r
- `in 2 hours` → 2 hours from now\r
- `in 3 days` → 3 days from now at current time\r
\r
### Time of Day Shortcuts\r
- `later today` / `later` / `this afternoon` → Today at 17:00\r
- `tonight` → Today at 20:00\r
- `tomorrow` → Tomorrow at 09:00\r
\r
### Tomorrow with Specific Time\r
Format: `tomorrow at [time]`\r
- `tomorrow at 3pm` → Tomorrow at 15:00\r
- `tomorrow at 10:30am` → Tomorrow at 10:30\r
- `tomorrow at 8pm` → Tomorrow at 20:00\r
\r
### Day of Week\r
Format: `next [weekday]` (lowercase required)\r
- `next monday` → Next Monday at 09:00\r
- `next friday` → Next Friday at 09:00\r
- `next sunday` → Next Sunday at 09:00\r
\r
**Note:** Day names must be lowercase (monday, tuesday, etc.)\r
\r
### ISO Format (fallback)\r
- `2026-01-27 14:00` → Exact date and time\r
\r
## Agent Implementation Guide\r
\r
### Creating Reminders\r
When user says: "Remind me to X at/in Y"\r
```bash\r
./create-reminder.sh "X" "Y"\r
```\r
\r
### Listing Reminders\r
When user asks: "What are my reminders?" or "Show my reminders"\r
```bash\r
./list-reminders.sh\r
```\r
\r
### Completing Reminders\r
When user says: "Mark [reminder] as done" or "Complete [reminder]"\r
1. List reminders to find the ID\r
2. Use the ID to complete:\r
```bash\r
./complete-reminder.sh "REMINDER-ID"\r
```\r
\r
### Editing Reminders\r
When user says: "Change [reminder] to say X" or "Reschedule [reminder] to Y"\r
1. List reminders to find the ID\r
2. Edit message or time:\r
```bash\r
./edit-reminder-message.sh "REMINDER-ID" "new message"\r
./edit-reminder-time.sh "REMINDER-ID" "new time"\r
```\r
\r
### Deleting Reminders\r
When user says: "Delete [reminder]" or "Remove [reminder]"\r
1. List reminders to find the ID\r
2. Delete:\r
```bash\r
./delete-reminder.sh "REMINDER-ID"\r
```\r
\r
## Workflow Examples\r
\r
### Complete Workflow: Find and Complete a Reminder\r
```bash\r
# 1. List all reminders\r
./list-reminders.sh | grep "Pay bills"\r
\r
# 2. Get the ID from output\r
# Output shows: ID: CDCBCB94-1215-494E-9F12-471AFEF25C09\r
\r
# 3. Mark as complete\r
./complete-reminder.sh "CDCBCB94-1215-494E-9F12-471AFEF25C09"\r
```\r
\r
### Complete Workflow: Reschedule a Reminder\r
```bash\r
# 1. List reminders and find the one to reschedule\r
./list-reminders.sh | grep "Team meeting"\r
\r
# 2. Reschedule to new time\r
./edit-reminder-time.sh "REMINDER-ID" "next friday at 2pm"\r
```\r
\r
## Technical Details\r
\r
- **Backend:** Uses `remindctl` command-line tool (macOS native)\r
- **Date Parsing:** BSD date utility (macOS compatible)\r
- **Time Format:** ISO 8601 timestamps for remindctl\r
- **List Filtering:** Shows only incomplete reminders by default\r
- **Sync:** All changes sync immediately to iCloud and all devices\r
\r
## Requirements\r
\r
- macOS (darwin)\r
- `remindctl` (installed at `/usr/local/bin/remindctl`)\r
- `date` (BSD version, macOS default)\r
- `python3` (for JSON parsing in list-reminders.sh)\r
- Apple Reminders.app\r
\r
## Limitations\r
\r
- Day of week parsing requires lowercase (e.g., "monday" not "Monday")\r
- "Next [weekday]" adds 7 days (doesn't calculate exact next occurrence)\r
- No support for recurring reminders\r
- No support for custom reminder lists (uses default "Reminders" list)\r
- No location-based reminders\r