> ## Documentation Index
> Fetch the complete documentation index at: https://docs.celestia.rest/llms.txt
> Use this file to discover all available pages before exploring further.

# Reminder System

> Set personal reminders and get notified at the right time

## Overview

The reminder system lets you set personal reminders for yourself. The bot will send you a notification when the time is up. Perfect for remembering tasks, events, or anything you need to be reminded about.

<Info>
  Reminders are personal - only you will receive notifications for your reminders.
</Info>

***

## Commands

<AccordionGroup>
  <Accordion title="remind" icon="clock">
    Set a new reminder for yourself.

    <CodeGroup>
      ```bash Syntax theme={null}
      ~remind <time> <message>
      ```

      ```bash Example theme={null}
      ~remind 30m Check the oven
      ~remind 2h Meeting with team
      ~remind 1d Submit assignment
      ~remind 3d Birthday party
      ~remindme 1M Renew subscription
      ```
    </CodeGroup>

    **Parameters:**

    * **time** — When to remind you (10s minimum, 1y maximum)
    * **message** — What to remind you about (max 200 characters)

    **Time Format:**

    * `s` = seconds (e.g., `30s`)
    * `m` = minutes (e.g., `15m`)
    * `h` = hours (e.g., `2h`)
    * `d` = days (e.g., `5d`)
    * `M` = months (e.g., `2M` = 60 days)
    * `y` = years (e.g., `1y` = 365 days)

    **Limits:**

    * Minimum: 10 seconds
    * Maximum: 1 year
    * Message: 200 characters max

    **Aliases:** `reminder`, `remindme`\
    **Permissions:** None
  </Accordion>

  <Accordion title="remind list" icon="list">
    View all your active reminders.

    <CodeGroup>
      ```bash Syntax theme={null}
      ~remind list
      ```

      ```bash Example theme={null}
      ~remind list
      ~reminder list
      ```
    </CodeGroup>

    **What It Shows:**

    * All your active reminders
    * Reminder message
    * When each reminder will trigger
    * Numbered list format

    **Aliases:** `reminder list`, `remindme list`\
    **Permissions:** None
  </Accordion>

  <Accordion title="remind clear" icon="trash">
    Clear all your active reminders.

    <CodeGroup>
      ```bash Syntax theme={null}
      ~remind clear
      ```

      ```bash Example theme={null}
      ~remind clear
      ~reminder clear
      ```
    </CodeGroup>

    **What It Does:**

    * Removes ALL your reminders
    * Cannot be undone
    * Does not affect other users' reminders

    <Warning>
      This clears all your reminders permanently.
    </Warning>

    **Aliases:** `reminder clear`, `remindme clear`\
    **Permissions:** None
  </Accordion>
</AccordionGroup>

***

## How It Works

<Steps>
  <Step title="Set a Reminder">
    Create a reminder with time and message:

    ```bash theme={null}
    ~remind 2h Meeting with Sarah
    ```
  </Step>

  <Step title="Bot Confirms">
    The bot confirms your reminder:

    ```
    ⏰ Reminder set for in 2 hours
    ```
  </Step>

  <Step title="Get Notified">
    When time is up, the bot sends you a DM or message:

    ```
    🔔 Reminder: Meeting with Sarah
    ```
  </Step>
</Steps>

***

## Time Format Guide

<Tabs>
  <Tab title="Seconds">
    ```bash theme={null}
    ~remind 30s Quick task
    ~remind 45s Check status
    ```

    **Format:** `<number>s`\
    **Range:** 10s - 59s\
    **Use for:** Very short reminders
  </Tab>

  <Tab title="Minutes">
    ```bash theme={null}
    ~remind 5m Break time
    ~remind 15m Check oven
    ~remind 30m Call back
    ~remind 90m Long meeting
    ```

    **Format:** `<number>m`\
    **Range:** 1m - unlimited\
    **Use for:** Short to medium tasks
  </Tab>

  <Tab title="Hours">
    ```bash theme={null}
    ~remind 1h Lunch break
    ~remind 2h Team meeting
    ~remind 4h End of workday
    ~remind 12h Tomorrow morning
    ```

    **Format:** `<number>h`\
    **Range:** 1h - unlimited\
    **Use for:** Same-day reminders
  </Tab>

  <Tab title="Days">
    ```bash theme={null}
    ~remind 1d Tomorrow's task
    ~remind 3d Appointment
    ~remind 7d Weekly check-in
    ~remind 14d Bi-weekly meeting
    ```

    **Format:** `<number>d`\
    **Range:** 1d - unlimited\
    **Use for:** Multi-day reminders
  </Tab>

  <Tab title="Months & Years">
    ```bash theme={null}
    ~remind 1M Monthly review
    ~remind 3M Quarterly report
    ~remind 6M Half-year review
    ~remind 1y Annual renewal
    ```

    **Format:** `<number>M` or `<number>y`\
    **Note:** 1M = 30 days, 1y = 365 days\
    **Use for:** Long-term reminders
  </Tab>
</Tabs>

***

## Permission Requirements

<Card title="No Permissions Needed" icon="user">
  Anyone can use reminders - no special permissions required.

  The bot needs permission to:

  * Send messages in the channel
  * Send DMs to users (for private reminders)
</Card>

***

## Aliases

<CardGroup cols={3}>
  <Card title="remind" icon="bell">
    Main command
  </Card>

  <Card title="reminder" icon="clock">
    Full form
  </Card>

  <Card title="remindme" icon="hand">
    Casual alias
  </Card>
</CardGroup>

***

## Usage Examples

<Tabs>
  <Tab title="Quick Reminders">
    ```bash theme={null}
    # Short-term tasks
    ~remind 5m Check the door
    ~remind 10m Timer is up
    ~remind 15m Break time
    ~remind 30m Call John back
    ```
  </Tab>

  <Tab title="Daily Tasks">
    ```bash theme={null}
    # Same-day reminders
    ~remind 1h Lunch meeting
    ~remind 2h Team standup
    ~remind 4h Submit report
    ~remind 8h End of shift
    ```
  </Tab>

  <Tab title="Multi-Day">
    ```bash theme={null}
    # Future reminders
    ~remind 1d Tomorrow's appointment
    ~remind 3d Doctor visit
    ~remind 7d Weekly review
    ~remind 14d Bi-weekly sync
    ```
  </Tab>

  <Tab title="Long-Term">
    ```bash theme={null}
    # Months ahead
    ~remind 1M Monthly report
    ~remind 2M Insurance renewal
    ~remind 6M Half-year review
    ~remind 1y Annual subscription
    ```
  </Tab>

  <Tab title="Management">
    ```bash theme={null}
    # View reminders
    ~remind list

    # Clear all reminders
    ~remind clear

    # Set multiple reminders
    ~remind 30m Task 1
    ~remind 1h Task 2
    ~remind 2h Task 3
    ```
  </Tab>
</Tabs>

***

## Common Use Cases

<AccordionGroup>
  <Accordion title="Work/study deadlines" icon="calendar">
    ```bash theme={null}
    ~remind 1d Submit assignment
    ~remind 3d Project deadline
    ~remind 1M Final exam
    ```

    Track important deadlines and assignments.
  </Accordion>

  <Accordion title="Meetings & appointments" icon="handshake">
    ```bash theme={null}
    ~remind 30m Team meeting in 30 minutes
    ~remind 2h Doctor appointment
    ~remind 1d Meeting with client tomorrow
    ```

    Never miss an important meeting.
  </Accordion>

  <Accordion title="Personal tasks" icon="list-check">
    ```bash theme={null}
    ~remind 5m Take medicine
    ~remind 1h Water the plants
    ~remind 12h Feed the pets
    ```

    Remember daily routines and chores.
  </Accordion>

  <Accordion title="Cooking & timers" icon="utensils">
    ```bash theme={null}
    ~remind 10m Check the oven
    ~remind 15m Stir the pot
    ~remind 45m Dinner is ready
    ```

    Set cooking timers and reminders.
  </Accordion>

  <Accordion title="Follow-ups" icon="reply">
    ```bash theme={null}
    ~remind 2h Follow up with John
    ~remind 1d Check if Sarah replied
    ~remind 3d Second follow-up
    ```

    Track when to follow up on messages.
  </Accordion>

  <Accordion title="Breaks & health" icon="heart">
    ```bash theme={null}
    ~remind 30m Take a break
    ~remind 1h Drink water
    ~remind 2h Stretch and move
    ```

    Remember to take care of yourself.
  </Accordion>
</AccordionGroup>

***

## Tips & Best Practices

<Info>
  **Setting Reminders**

  * Be specific in your reminder text
  * Use appropriate time units (don't use `120m`, use `2h`)
  * Set reminders in advance, not last minute
  * Keep messages under 200 characters
  * Use `~remind list` to track all your reminders
</Info>

<Note>
  **Managing Reminders**

  * Check your reminder list regularly
  * Clear old reminders you no longer need
  * Set buffer time (remind 15m before, not at exact time)
  * Use reminders for recurring tasks
  * Consider timezone - reminders use your current time
</Note>

***

## Troubleshooting

### Not Receiving Reminders

**Issue:** You didn't receive the reminder notification.

**Solutions:**

1. Check if bot can send DMs (enable DMs from server members)
2. Verify you haven't blocked the bot
3. Check if the reminder was set correctly with `~remind list`
4. Ensure the channel where you set the reminder still exists

### "Invalid time format"

**Issue:** Bot doesn't recognize your time format.

**Solutions:**

1. Use format: `<number><unit>` (e.g., `30m`, not `30 minutes`)
2. Valid units: `s`, `m`, `h`, `d`, `M`, `y`
3. No spaces between number and unit
4. Use whole numbers only

### "Reminder must be at least 10 seconds"

**Issue:** Time is too short.

**Solution:** Set reminders for at least 10 seconds (use `10s` or longer)

### "Reminder cannot be more than 1 year"

**Issue:** Time is too long.

**Solution:** Maximum reminder time is 1 year (365 days)

***

## Important Notes

<Warning>
  **Limitations**

  * Reminders are stored locally and may be lost if bot restarts
  * No recurring/repeating reminders (set manually each time)
  * Maximum 1 year in advance
  * Minimum 10 seconds
  * 200 character limit on reminder text
</Warning>

<Info>
  **Delivery**

  * Reminders are sent via DM if possible
  * Falls back to the channel where you set the reminder
  * You must have DMs enabled from server members
  * Bot must have permission to message you
</Info>

***

## Related Features

<CardGroup cols={2}>
  <Card title="Message Counter" icon="chart-line" href="/message-counter">
    Track activity and stats
  </Card>

  <Card title="Giveaways" icon="gift" href="/giveaway">
    Set up timed events and giveaways
  </Card>

  <Card title="Auto Responders" icon="reply" href="/auto-responders">
    Automated message responses
  </Card>

  <Card title="Welcome Messages" icon="hand-wave" href="/welcome">
    Automated welcome system
  </Card>
</CardGroup>
