quick-reminders

name	quick-reminders
description	Zero-LLM one-shot reminders (<48h) via nohup sleep + openclaw message send, operated via {baseDir}/scripts/nohup-reminder.sh.
metadata	{"openclaw":{"emoji":"⏰","requires":{"bins":["jq","openclaw"]}}}
user-invocable	true

Quick Reminders

One-shot reminders for < 2 days ahead. Agent composes the final delivery text at creation time. At fire time a background process sends it via openclaw message send — zero LLM tokens.

Guardrail — 2+ days? Use calendar instead

If the user asks for a reminder 2 or more days from now, do NOT use this skill. Instead, create a calendar event (if the user has a calendar or an appropriate skill is available) with an appropriate reminder notification. Explain briefly: "I'll add it to your calendar with a reminder so it won't be lost."

---

All operations go through the CLI: bash {baseDir}/scripts/nohup-reminder.sh <command> [args]

If {baseDir} is not resolved, use workspace-relative: bash ./skills/quick-reminders/scripts/nohup-reminder.sh <command> [args]

--target: Delivery target from TOOLS.md (§ Reminders). Required for add. Format depends on channel (e.g. Telegram chat ID, WhatsApp E.164 number, Discord channel ID). If missing in TOOLS.md — check session_status tool for deliveryContext.to (strip channel prefix like telegram:), save to TOOLS.md, and use it.

Channel: Telegram by default. Override with --channel <name> (e.g. whatsapp, discord, signal, imessage).

---

Commands

Add

nohup-reminder.sh add "Reminder text here" --target <chat_id> -t TIME [--channel CH] [-z TIMEZONE]

• Text: the exact message the user will receive. Compose it yourself — keep your voice, add a CTA or helpful note when relevant.
• -t: relative (30s, 20m, 2h, 1d, 1h30m) or absolute ISO-8601 (2026-02-07T16:00:00+03:00)
• -z: IANA timezone for naive absolute times (default: system local)

List

nohup-reminder.sh list

Auto-prunes fired entries.

Remove

nohup-reminder.sh remove ID [ID ...]
nohup-reminder.sh remove --all

---

Composing the reminder message

The reminder should feel like a friend texting you, not a system notification. No robotic phrasing.

Never:

• "Reminder: call John"
• "This is your reminder to..."
• "You asked to be reminded about..."
• "Task: load dishwasher"

Instead — sound human:

• "Hey, you wanted to call John"
• "Time to call John back"
• "So... dishwasher time"
• "I know you hate it, but the dishwasher won't load itself"
• "Package is waiting — go grab it"

Guidelines:

• Use casual openers: "Hey", "So...", "Heads up", "{UserName}", or just dive in
• Okay to add light humor or empathy when it fits ("I know, I know...")
• Keep it short — one line, no formalities
• The user reads this out of context hours later; it should still make sense

---

Examples (copy-paste ready, replace <chat_id> with actual ID)

User: "Remind me to call John in 2 hours"

bash {baseDir}/scripts/nohup-reminder.sh add "Hey, you wanted to call John" --target <chat_id> -t 2h

User: "Remind me in 20 minutes to grab the laundry"

bash {baseDir}/scripts/nohup-reminder.sh add "Laundry's ready — go grab it" --target <chat_id> -t 20m

User: "Set a reminder for today at 6pm — pick up the package"

bash {baseDir}/scripts/nohup-reminder.sh add "Package is waiting for you" --target <target> -t "2026-02-07T18:00:00" -z "America/New_York"

User: "Remind me via WhatsApp in 30 min to check the oven"

bash {baseDir}/scripts/nohup-reminder.sh add "Check the oven!" --target [phone] -t 30m --channel whatsapp

User: "What reminders do I have?"

bash {baseDir}/scripts/nohup-reminder.sh list

User: "Cancel reminder #3"

bash {baseDir}/scripts/nohup-reminder.sh remove 3

User: "Cancel reminders 1 and 4"

bash {baseDir}/scripts/nohup-reminder.sh remove 1 4

User: "Clear all my reminders"

bash {baseDir}/scripts/nohup-reminder.sh remove --all

---

Rules

1. Compose the delivery text yourself at creation time. No LLM runs when it fires.
2. Text must make sense to the user out of context.
3. Confirm with one short word/phrase — e.g. "Will do", "Will remind you", "Got it", in future tense. Not "Done", "Added", "Created", "Reminder X is set for Y". No IDs, no times, no details.
4. To change: remove old, then add new.