CLI Reference
memories reminders
Manage cron-based reminders from the CLI.
memories reminders <subcommand> [options]Create and run lightweight cron-style reminders stored in your local memories database.
Subcommands
memories reminders add <cron> <message...>
Create a reminder with a 5-field cron expression.
| Option | Description |
|---|---|
-g, --global | Store reminder as global (default is project-scoped inside a git repo) |
--json | Output created reminder as JSON |
memories reminders add "0 9 * * 1-5" "Standup prep"
memories reminders add "*/30 * * * *" "Stretch break" --globalmemories reminders list
List reminders visible in the current scope.
| Option | Description |
|---|---|
--all | Include disabled reminders |
--json | Output list as JSON |
memories reminders list
memories reminders list --all --jsonmemories reminders run
Evaluate due reminders and emit them to stdout.
| Option | Description |
|---|---|
--dry-run | Show due reminders without advancing schedule |
--json | Output result as JSON |
memories reminders run
memories reminders run --dry-runmemories reminders enable <id>
Enable a reminder and recompute its next trigger time.
memories reminders disable <id>
Disable a reminder (keeps reminder record, stops triggering).
memories reminders delete <id>
Delete a reminder permanently.
Cron Format
Use standard 5-field cron syntax:
minute hour day-of-month month day-of-weekExamples:
*/15 * * * *every 15 minutes0 9 * * 1-59:00 AM Monday-Friday30 18 1 * *6:30 PM on day 1 of each month
Running on a Schedule
memories reminders run only checks and emits reminders when it executes. To automate it, run it from your system scheduler (cron, launchd, systemd timer, CI scheduler, etc.).
Example cron entry (every minute):
* * * * * /usr/local/bin/memories reminders run