Nag — Persistent Reminders

Nag manages reminders that don't give up. Each reminder has a first-fire time, a nag window, and resets daily.

When to Use

• Recurring daily habits (supplements, workouts, practice)
• Tasks that get ignored/forgotten without follow-up
• Anything where "remind me once" isn't enough

When NOT to Use

• One-shot reminders ("remind me in 20 minutes") — use a cron job with schedule.kind: "at"
• Time-critical alerts that can't wait for a heartbeat cycle
• Reminders that don't need confirmation (informational only)

Setup

1. State File