Remind Me

Natural language reminders that fire automatically. Uses cron for scheduling, markdown for logging.

Usage

One-Time Reminders

Just ask naturally:

• "Remind me to pay for Gumroad later today"

• "Remind me to call mom tomorrow at 3pm"

• "Remind me in 2 hours to check the oven"

• "Remind me next Monday at 9am about the meeting"

Recurring Reminders

For repeating reminders:

• "Remind me every hour to stretch"

• "Remind me every day at 9am to check email"

• "Remind me every Monday at 2pm about the meeting"

• "Remind me weekly to submit timesheet"

How It Works

• Parse the time from your message

• Create a one-time cron job with --at

• Log to /home/julian/clawd/reminders.md for history

• At the scheduled time, you get a message

Time Parsing

One-Time Reminders

Relative:

• "in 5 minutes" / "in 2 hours" / "in 3 days"

• "later today" → 17:00 today

• "this afternoon" → 15:00 today

• "tonight" → 20:00 today

Absolute:

• "tomorrow" → tomorrow 9am

• "tomorrow at 3pm" → tomorrow 15:00

• "next Monday" → next Monday 9am

• "next Monday at 2pm" → next Monday 14:00

Dates:

• "January 15" → Jan 15 at 9am

• "Jan 15 at 3pm" → Jan 15 at 15:00

• "2026-01-15" → Jan 15 at 9am

• "2026-01-15 14:30" → Jan 15 at 14:30

Recurring Reminders

Intervals:

• "every 30 minutes"

• "every 2 hours"

Daily:

• "daily at 9am"

• "every day at 3pm"

Weekly:

• "weekly" → every Monday at 9am

• "every Monday at 2pm"

• "every Friday at 5pm"

Reminder Log

All reminders are logged to /home/julian/clawd/reminders.md:

- [scheduled] 2026-01-06 17:00 | Pay for Gumroad (id: abc123)

- [recurring] every 2h | Stand up and stretch (id: def456)

- [recurring] cron: 0 9 * * 1 | Weekly meeting (id: ghi789)

Status:

• [scheduled] — one-time reminder waiting to fire

• [recurring] — repeating reminder (active)

• [sent] — one-time reminder already delivered

Manual Commands

# List pending reminders

cron list

# View reminder log

cat /home/julian/clawd/reminders.md

# Remove a scheduled reminder

cron rm <job-id>

Agent Implementation

One-Time Reminders

When the user says "remind me to X at Y":

bash /home/julian/clawd/skills/remind-me/create-reminder.sh "X" "Y"

Examples:

bash /home/julian/clawd/skills/remind-me/create-reminder.sh "Pay for Gumroad" "later today"

bash /home/julian/clawd/skills/remind-me/create-reminder.sh "Call dentist" "tomorrow at 3pm"

bash /home/julian/clawd/skills/remind-me/create-reminder.sh "Check email" "in 2 hours"

Recurring Reminders

When the user says "remind me every X to Y":

bash /home/julian/clawd/skills/remind-me/create-recurring.sh "Y" "every X"

Examples:

bash /home/julian/clawd/skills/remind-me/create-recurring.sh "Stand up and stretch" "every 2 hours"

bash /home/julian/clawd/skills/remind-me/create-recurring.sh "Check email" "daily at 9am"

bash /home/julian/clawd/skills/remind-me/create-recurring.sh "Weekly team meeting" "every Monday at 2pm"

Both scripts automatically:

• Parse the time/schedule

• Create a cron job (one-time with --at or recurring with --every/--cron)

• Log to /home/julian/clawd/reminders.md

• Return confirmation with job ID