lordluceus/scheduling

Scheduling

Schedule recurring tasks or one-off reminders.

Quick Reference

lettabot-schedule list                    # List all jobs
lettabot-schedule create [options]        # Create job
lettabot-schedule delete ID               # Delete job
lettabot-schedule enable ID               # Enable job
lettabot-schedule disable ID              # Disable job

One-Off Reminders (--at)

For reminders at a specific future time, use --at with an ISO datetime.

Calculate the datetime in JavaScript:

// 5 minutes from now
new Date(Date.now() + 5*60*1000).toISOString()
// → "2026-01-28T20:15:00.000Z"

// 1 hour from now
new Date(Date.now() + 60*60*1000).toISOString()

// Tomorrow at 9am (approximate)
new Date(Date.now() + 24*60*60*1000).toISOString()

Create the reminder:

lettabot-schedule create \
  --name "Standup" \
  --at "2026-01-28T20:15:00.000Z" \
  --message "Time for standup!"

One-off reminders auto-delete after running.

Options:

• -n, --name - Job name (required)
• -a, --at - ISO datetime for one-off reminder (e.g., "2026-01-28T20:15:00Z")
• -m, --message - Message sent to you when job runs (required)
• -d, --deliver - Where to send response (format: channel:chatId). Defaults to last messaged chat.

Recurring Schedules (--schedule)

For recurring tasks, use --schedule with a cron expression.

lettabot-schedule create \
  --name "Morning Briefing" \
  --schedule "0 8 * * *" \
  --message "Good morning! What's on today's agenda?"

Options:

• -n, --name - Job name (required)
• -s, --schedule - Cron expression (required for recurring)
• -m, --message - Message sent to you when job runs (required)
• -d, --deliver - Where to send response (format: channel:chatId). Defaults to last messaged chat.
• --disabled - Create disabled

Cron Schedule Syntax

┌───────── minute (0-59)
│ ┌─────── hour (0-23)  
│ │ ┌───── day of month (1-31)
│ │ │ ┌─── month (1-12)
│ │ │ │ ┌─ day of week (0-6, Sun=0)
* * * * *

| Pattern | When | |---------|------| | 0 8 * * * | Daily at 8:00 AM | | 0 9 * * 1-5 | Weekdays at 9:00 AM | | 0 */2 * * * | Every 2 hours | | 30 17 * * 5 | Fridays at 5:30 PM | | 0 0 1 * * | First of month at midnight |

Examples

Remind me in 30 minutes:

# First calculate: new Date(Date.now() + 30*60*1000).toISOString()
lettabot-schedule create \
  -n "Break reminder" \
  --at "2026-01-28T20:45:00.000Z" \
  -m "Time for a break!"

Daily morning check-in:

lettabot-schedule create \
  -n "Morning" \
  -s "0 8 * * *" \
  -m "Good morning! What's on today's agenda?"

Weekly review on Fridays:

lettabot-schedule create \
  -n "Weekly Review" \
  -s "0 17 * * 5" \
  -m "Friday wrap-up: What did we accomplish?"

Message Format

When a scheduled job runs, you receive:

[cron:job-123abc Morning] Good morning! What's on today's agenda?
Current time: 1/27/2026, 8:00:00 AM (America/Los_Angeles)

Notes

• Jobs activate immediately when created (no restart needed)
• One-off reminders (--at) auto-delete after running
• Use lettabot-schedule list to see next run times
• Jobs persist in cron-jobs.json