mirror of
https://github.com/NousResearch/hermes-agent.git
synced 2026-06-09 08:21:50 +00:00
docs(skills): clarify Reminders alarm timing
This commit is contained in:
parent
62e81b2d9b
commit
2520c9ad68
2 changed files with 64 additions and 0 deletions
|
|
@ -68,6 +68,38 @@ remindctl add --title "Call mom" --list Personal --due tomorrow
|
|||
remindctl add --title "Meeting prep" --due "2026-02-15 09:00"
|
||||
```
|
||||
|
||||
### Due Time vs Alarm / Early Nudge
|
||||
|
||||
`--due` and `--alarm` are different fields:
|
||||
|
||||
- `--due` sets the reminder's due date/time.
|
||||
- `--alarm` sets the EventKit alarm/notification trigger. Timed due reminders may default to an alarm at the due time, but pass `--alarm` explicitly when the user asks for an earlier nudge.
|
||||
|
||||
For a reminder due at 2:00 PM with a notification 30 minutes earlier:
|
||||
|
||||
```bash
|
||||
remindctl add --title "Hairdresser" --due "2026-05-15 14:00" --alarm "2026-05-15 13:30"
|
||||
```
|
||||
|
||||
To edit an existing reminder:
|
||||
|
||||
```bash
|
||||
remindctl edit 87354 --due "2026-05-15 14:00" --alarm "2026-05-15 13:30"
|
||||
```
|
||||
|
||||
The Reminders UI may show or group the item by the alarm time because that is when the notification fires. Verify with JSON instead of assuming the due time moved:
|
||||
|
||||
```bash
|
||||
remindctl today --json
|
||||
```
|
||||
|
||||
Expected shape:
|
||||
|
||||
- `dueDate`: actual due time
|
||||
- `alarmDate`: notification / early nudge time
|
||||
|
||||
Apple's public `EKReminder` docs list only reminder-specific properties. Alarm support comes from inherited `EKCalendarItem` behavior exposed by remindctl's `--alarm` flag.
|
||||
|
||||
### Complete / Delete
|
||||
|
||||
```bash
|
||||
|
|
|
|||
|
|
@ -84,6 +84,38 @@ remindctl add --title "Call mom" --list Personal --due tomorrow
|
|||
remindctl add --title "Meeting prep" --due "2026-02-15 09:00"
|
||||
```
|
||||
|
||||
### Due Time vs Alarm / Early Nudge
|
||||
|
||||
`--due` and `--alarm` are different fields:
|
||||
|
||||
- `--due` sets the reminder's due date/time.
|
||||
- `--alarm` sets the EventKit alarm/notification trigger. Timed due reminders may default to an alarm at the due time, but pass `--alarm` explicitly when the user asks for an earlier nudge.
|
||||
|
||||
For a reminder due at 2:00 PM with a notification 30 minutes earlier:
|
||||
|
||||
```bash
|
||||
remindctl add --title "Hairdresser" --due "2026-05-15 14:00" --alarm "2026-05-15 13:30"
|
||||
```
|
||||
|
||||
To edit an existing reminder:
|
||||
|
||||
```bash
|
||||
remindctl edit 87354 --due "2026-05-15 14:00" --alarm "2026-05-15 13:30"
|
||||
```
|
||||
|
||||
The Reminders UI may show or group the item by the alarm time because that is when the notification fires. Verify with JSON instead of assuming the due time moved:
|
||||
|
||||
```bash
|
||||
remindctl today --json
|
||||
```
|
||||
|
||||
Expected shape:
|
||||
|
||||
- `dueDate`: actual due time
|
||||
- `alarmDate`: notification / early nudge time
|
||||
|
||||
Apple's public `EKReminder` docs list only reminder-specific properties. Alarm support comes from inherited `EKCalendarItem` behavior exposed by remindctl's `--alarm` flag.
|
||||
|
||||
### Complete / Delete
|
||||
|
||||
```bash
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue