npx reminders add "<datetime>" "<message>"

npx reminders add "in 30 minutes" "Call mom"
npx reminders add "tomorrow" "Dentist appointment"
npx reminders add "2026-02-15 09:00" "Team meeting"
npx reminders add "14:30" "Standup meeting"

npx reminders recurring <type> "<time>" "<message>"

npx reminders recurring daily "09:00" "Take vitamins"
npx reminders recurring weekly "Monday 10:00" "Weekly review"
npx reminders recurring monthly "1st 12:00" "Pay rent"

npx reminders list                    # List pending reminders
npx reminders list --all              # Include completed
npx reminders list --limit 20         # Limit results

npx reminders due                     # Show reminders that are due now

npx reminders get <id>

npx reminders complete <id>

npx reminders snooze <id> <minutes>

npx reminders snooze 123 30          # Snooze for 30 minutes

npx reminders delete <id>

npx reminders history                 # Show completed reminders
npx reminders history --limit 50      # Show last 50

npx reminders stats                   # Show pending, completed, overdue counts

npx reminders daemon                  # Output JSON with due reminders

# Check for reminders every minute
* * * * * /usr/bin/node /path/to/dist/cli.js daemon | some-notifier

npx reminders health                  # Check database status

npx reminders parse "in 2 hours"      # Test how a datetime string is parsed

import { RemindersSkill } from '@openclaw/reminders';

const reminders = new RemindersSkill();

// Add a one-time reminder
const reminder = await reminders.addReminder({
  message: "Call mom",
  scheduledAt: new Date("2026-02-15T14:00:00"),
});

// Parse natural language datetime
const when = reminders.parseNaturalDateTime("in 2 hours");
await reminders.addReminder({
  message: "Take a break",
  scheduledAt: when,
});

// Add recurring reminder
await reminders.addRecurringReminder({
  message: "Take vitamins",
  type: "daily",
});

// List due reminders
const due = await reminders.getDueReminders();

// Complete a reminder
await reminders.completeReminder(reminder.id);

// Snooze for 30 minutes
await reminders.snoozeReminder(reminder.id, 30);

// Close connection
await reminders.close();