From e648febfa9a83b85df539f7f99d6b5e91ebf2ce2 Mon Sep 17 00:00:00 2001 From: Mario Zechner Date: Fri, 12 Dec 2025 23:00:22 +0100 Subject: [PATCH] mom: add timezone and external event creation info to README --- packages/mom/README.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/packages/mom/README.md b/packages/mom/README.md index 2c4796f0..89774b20 100644 --- a/packages/mom/README.md +++ b/packages/mom/README.md @@ -216,6 +216,14 @@ Mom can schedule events that wake her up at specific times or when external thin **Silent completion:** For periodic events that check for activity (inbox, notifications), mom may find nothing to report. She can respond with just `[SILENT]` to delete the status message and post nothing to Slack. This prevents channel spam from periodic checks. +**Timezones:** +- One-shot `at` timestamps must include timezone offset (e.g., `+01:00`, `-05:00`) +- Periodic events use IANA timezone names (e.g., `Europe/Vienna`, `America/New_York`) +- The harness runs in the host's timezone. Mom is told this timezone in her system prompt + +**Creating events yourself:** +You can write event files directly to `data/events/` on the host machine. This lets external systems (cron jobs, webhooks, CI pipelines) wake mom up without going through Slack. Just write a JSON file and mom will be triggered. + **Limits:** - Maximum 5 events can be queued per channel - Use unique filenames (e.g., `reminder-$(date +%s).json`) to avoid overwrites