69 lines
2.0 KiB
Markdown
69 lines
2.0 KiB
Markdown
---
|
|
name: remind
|
|
description: >
|
|
Create, list, edit, enable, disable, and remove recurring or one-time reminders.
|
|
Triggers on: "/remind", "remind me", "set a reminder".
|
|
---
|
|
|
|
# /remind
|
|
|
|
## Commands
|
|
|
|
### Create
|
|
```
|
|
/remind <text> every day at 9:00
|
|
/remind <text> every weekday at 9:30
|
|
/remind <text> at 2026-06-15T18:00
|
|
/remind <text> randomly 2 times between 08:00 and 20:00
|
|
/remind <text> once daily at random time between 8:00 and 21:00
|
|
```
|
|
|
|
Parse natural language, then call `remind_edit.py add` with flags:
|
|
- `--text "..."`
|
|
- `--cron "0 9 * * *"` (repeatable)
|
|
- `--at "2026-06-15T18:00:00"` (repeatable)
|
|
- `--random-times-per-day N --random-window HH:MM-HH:MM [--random-days DOW] [--random-from YYYY-MM-DD] [--random-until YYYY-MM-DD]`
|
|
|
|
### List
|
|
```
|
|
/remind list
|
|
```
|
|
Call `remind_edit.py list` → JSON with all active reminders.
|
|
|
|
### Edit
|
|
```
|
|
/remind edit <keyword> --text "new text"
|
|
/remind edit <keyword> --replace-schedules --cron "0 10 * * *"
|
|
```
|
|
Call `remind_edit.py edit --keyword <keyword>`. Keyword matches case-insensitively against reminder text. Ambiguous matches are rejected.
|
|
|
|
### Enable / Disable
|
|
```
|
|
/remind disable <keyword>
|
|
/remind enable <keyword>
|
|
```
|
|
|
|
### Remove
|
|
```
|
|
/remind remove <keyword>
|
|
```
|
|
Soft delete. Hard delete only via direct DB access.
|
|
|
|
## Scripts
|
|
|
|
| Action | Command |
|
|
|--------|---------|
|
|
| list | `uv run skills/remind/scripts/remind_edit.py list` |
|
|
| add | `uv run skills/remind/scripts/remind_edit.py add --text "..." ...` |
|
|
| edit | `uv run skills/remind/scripts/remind_edit.py edit --keyword <kw> ...` |
|
|
| remove | `uv run skills/remind/scripts/remind_edit.py remove --keyword <kw>` |
|
|
| enable | `uv run skills/remind/scripts/remind_edit.py enable --keyword <kw>` |
|
|
| disable | `uv run skills/remind/scripts/remind_edit.py disable --keyword <kw>` |
|
|
|
|
Sender runs every minute from crontab: `uv run skills/remind/scripts/remind_send.py`
|
|
|
|
## Environment
|
|
|
|
- `REMIND_DB` — override SQLite path (used in tests).
|
|
- `python3` required; `python` unavailable.
|