Upcoming Birthdays Reminder

Daily check against a CSV birthday list. Notifies the owner when one or more birthdays fall within a configurable lookahead window.

What it does

Every morning (default — edit the schedule when you install), the monitor calls the birthday-checker tool against your CSV file with a 7-day lookahead. If the tool finds any upcoming birthdays, the when: arm fires a notification listing them. If none are upcoming, the else: arm matches and nothing fires.

Edit before installing

In monitor.yaml:

• check.args.birthdayFile — path to your CSV. Format is three columns, no header: name,month,day (e.g. Alice,11,23 for November 23rd).
• check.args.daysAhead — lookahead window in days. 7 is one week, 1 only notifies on the actual birthday.

Create the CSV first; the monitor will fail silently if the file doesn't exist (the tool reports zero upcoming and the else: arm matches).

Bindings used

• {{check.count}} — number of upcoming birthdays in the window (number).
• {{check.upcoming}} — formatted multi-line list of upcoming birthdays.
• {{check.message}} — one-line summary string.

Tool used

birthday-checker — hub-installed YAML tool, reads a local CSV. No API key, no remote calls.

Pattern showcase

The simplest "is there anything to do today?" monitor shape — a single arm gated on count > 0, with else: nothing to stay quiet on empty days. This same shape works for any tool that publishes a count of pending / matching items: upcoming meetings, unread alerts, expiring certificates, etc.