Reminders Cog

The Reminders cog allows users to set personal reminders that are delivered via direct message at specified times.

Features

Reminder System

  • Time-based Reminders: Set reminders for future times
  • Flexible Units: Support seconds, minutes, hours, days
  • DM Delivery: Reminders sent via private message
  • Persistent Storage: Reminders survive bot restarts

Management

  • List Reminders: View upcoming reminders
  • Cancel Reminders: Remove unwanted reminders
  • Edit Reminders: Modify reminder times/messages
  • Bulk Operations: Handle multiple reminders

Limits & Safety

  • User Limits: Maximum reminders per user
  • Time Limits: Maximum reminder duration
  • Content Limits: Message length restrictions
  • Rate Limiting: Prevent abuse

Commands

Command Description
/remindme <time> <message> Quick reminder (e.g., /remindme 1h30m meeting)
/reminders add <time> <message> Add a reminder
/reminders list View your active reminders
/reminders remove <id> Delete a reminder by ID
/reminders help Display reminder help

Prefix Commands

Command Description
!remindme <time> <message> Quick reminder (prefix version)

Configuration

  • Enabled: Toggle reminders system
  • Max Reminders: Configurable per-user limit (replaces the previous hard-coded limit of 10)
  • Max Duration: Longest allowed reminder
  • Scheduler: Background task management

Best Practices

  1. Reasonable Limits: Prevent system abuse
  2. Clear Time Format: Educate users on time syntax
  3. Privacy: Keep reminders private
  4. Reliability: Ensure timely delivery