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

# Setting Up Reminders

> Set one-time or recurring reminders in plain language, no forms, no date pickers

export const Chat = ({messages = []}) => {
  const css = `
.docs-imsg-list {
  display: flex;
  flex-direction: column;
  gap: 4px;
  margin: 1.25rem 0;
}
.docs-imsg-bubble {
  word-wrap: break-word;
  line-height: 24px;
  position: relative;
  padding: 8px 20px;
  max-width: 85%;
  border-radius: 20px;
  font-size: 0.875rem;
  white-space: pre-line;
}
.docs-imsg-bubble::before {
  content: "";
  position: absolute;
  bottom: 0;
  width: 20px;
  height: 18px;
}
.docs-imsg-from-them {
  background: #27272a;
  color: #fafafa;
  align-self: flex-start;
}
.docs-imsg-from-them::before {
  left: -7px;
  background-color: #27272a;
  clip-path: path("M 20 0 L 20 2 A 16 16 0 0 1 4 18 L 0 18 L 0 17.54 A 10 10 0 0 0 7 8 L 7 0 Z");
}
.docs-imsg-from-me {
  color: black;
  background: #00bbff;
  align-self: flex-end;
}
.docs-imsg-from-me::before {
  right: -7px;
  background-color: #00bbff;
  clip-path: path("M 0 0 L 0 2 A 16 16 0 0 0 16 18 L 20 18 L 20 17.54 A 10 10 0 0 1 13 8 L 13 0 Z");
}
.docs-imsg-no-tail::before {
  display: none;
}
.docs-imsg-group-gap {
  margin-top: 8px;
}
`;
  return <div className="docs-imsg-list not-prose">
      <style>{css}</style>
      {messages.map((msg, idx) => {
    const from = msg.from === "user" ? "me" : "them";
    const next = messages[idx + 1];
    const prev = messages[idx - 1];
    const lastOfGroup = !next || next.from !== msg.from;
    const newGroup = prev && prev.from !== msg.from;
    const classes = ["docs-imsg-bubble", `docs-imsg-from-${from}`, lastOfGroup ? "" : "docs-imsg-no-tail", newGroup ? "docs-imsg-group-gap" : ""].filter(Boolean).join(" ");
    return <div key={idx} className={classes}>
            {msg.text}
          </div>;
  })}
    </div>;
};

Tell GAIA what to remember and when, in plain language. It schedules the reminder, confirms the time, and notifies you when the moment comes, in-app, and as a push notification on mobile.

Reminders work everywhere you talk to GAIA: web, mobile, desktop, and your connected bots (Discord, Slack, Telegram).

## What to say

<Chat
  messages={[
{ from: "user", text: "remind me to take my medication every day at 8 PM" },
{ from: "gaia", text: "Set, I'll remind you every day at 8 PM." },
{ from: "user", text: "actually make that 9 PM instead" },
{ from: "gaia", text: "Updated, your medication reminder now fires every day at 9 PM." },
]}
/>

One-off or recurring, phrased however feels natural:

* "remind me to call the dentist in 30 minutes"
* "remind me to submit the quarterly report tomorrow at 9 AM"
* "every Monday at 9 AM, remind me to review my weekly goals"

GAIA replies with a confirmation showing the reminder text and scheduled time. You're done.

## One-time reminders

These fire once, then they're done. Use them for deadlines, appointments, or anything with a single due date.

| What you say                                     | What GAIA schedules                       |
| ------------------------------------------------ | ----------------------------------------- |
| "Remind me to call the dentist in 30 minutes"    | 30 minutes from now                       |
| "Remind me to buy groceries at 5 PM today"       | Today at 5:00 PM                          |
| "Remind me to renew my subscription on March 20" | March 20 at the time you send the message |
| "Remind me in 2 hours to check the oven"         | 2 hours from now                          |

<Tip>
  Relative times like "in 10 minutes" or "in 3 hours" are the fastest way to
  set a quick reminder. GAIA works out the exact time for you.
</Tip>

## Recurring reminders

These repeat on a schedule until you cancel them or set a limit. Use them for habits, weekly check-ins, or anything regular.

| What you say                                                | Schedule                         |
| ----------------------------------------------------------- | -------------------------------- |
| "Remind me to stand up and stretch every 2 hours"           | Every 2 hours during the day     |
| "Every Monday at 9 AM, remind me to review my weekly goals" | Weekly on Mondays at 9:00 AM     |
| "On the first of every month, remind me to pay rent"        | Monthly on the 1st               |
| "Every weekday at 6 PM, remind me to wrap up for the day"   | Monday through Friday at 6:00 PM |

To set a limit, say when to stop:

<Chat
  messages={[
{ from: "user", text: "remind me to water the plants every 3 days, 10 times total" },
{ from: "user", text: "every Tuesday at noon, remind me to submit timesheets until June 30" },
{ from: "gaia", text: "Scheduled, every Tuesday at noon, ending June 30." },
]}
/>

<Note>
  Recurring reminders automatically expire after 6 months unless you set an
  end date. You can extend or cancel them at any time.
</Note>

## Managing your reminders

Everything happens in chat, list, update, pause, resume, and cancel.

<Chat
  messages={[
{ from: "user", text: "pause my weekday wrap-up reminder" },
{ from: "gaia", text: "Paused, it won't fire until you resume it." },
{ from: "user", text: "resume it" },
{ from: "gaia", text: "Resumed, the next one fires tomorrow." },
]}
/>

Also works: "show me my upcoming reminders", "change my daily medication reminder to 9 PM", "cancel my Monday goals reminder".

Pausing keeps the reminder around without firing it, handy for vacations.

<Warning>
  Cancelled reminders cannot be restored. If you might want it back later,
  pause it instead.
</Warning>

## Timezones

GAIA uses your local timezone by default, "at 3 PM" means 3 PM your time. To use a different timezone, say so:

<Chat
  messages={[
{ from: "user", text: "remind me to join the call at 2 PM EST tomorrow" },
{ from: "gaia", text: "Set, I'll remind you tomorrow at 2 PM EST." },
]}
/>

## Reminders vs. workflows

Reminders and [workflows](/guides/building-workflows) do different things:

|                | Reminders                               | Workflows                                  |
| -------------- | --------------------------------------- | ------------------------------------------ |
| **Purpose**    | Nudge you at a specific time            | Automate a multi-step process              |
| **Output**     | A notification with a title and message | Actions across your connected apps         |
| **Trigger**    | Time-based (one-time or recurring)      | Time-based, event-based, or manual         |
| **Complexity** | Single message                          | Multiple steps with logic and integrations |

Use a reminder when you need a nudge. Use a workflow when you want GAIA to act on your behalf, like sending a summary email or pulling data from a connected service.

<Tip>
  They work well together: set a reminder to review something, and a workflow
  to prepare the information before you sit down.
</Tip>

## Tips for better reminders

* **Be specific.** "Remind me to email Sarah about the contract renewal" beats "Remind me about Sarah."
* **Use relative times for quick reminders.** "In 15 minutes" is faster than working out the exact time.
* **Set recurring reminders for habits.** Consistency is easier when you don't have to remember to remember.
* **Review periodically.** Ask GAIA to list your active reminders and clear out the ones you no longer need.