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

# Automations

> Reminders, summaries and alerts: things GAIA does on its own and messages you about later.

Ask GAIA to do something later, on a schedule, or only when something changes, and it
messages you when there's something to say. You set it up the same way you ask GAIA
anything: in plain words.

> [!NOTE]
>
> GAIA sends these messages through [Discord](https://amd-gaia.ai/docs/guides/discord.md), so set that up first. If
> nothing is there to deliver a message, GAIA tells you when you ask.

## What you can ask for

**Reminders**: a message at a set time, once.

* "Remind me in 10 minutes to stretch."
* "Remind me at 5pm to call Sam."

**Summaries**: a regular report.

* "Every weekday at 8am, tell me what changed on github.com/my-org/my-app."
* "Every evening, summarize the news about AMD."

**Alerts**: GAIA keeps checking, and messages you only when there's news. It never tells
you the same thing twice.

* "Tell me if a test breaks on the main branch of my-org/my-app."
* "Tell me when pull request 12 is approved."
* "Let me know when there's a good weekend to climb Mount Rainier."
* "Tell me if the price of a Steam Deck OLED drops under \$450."

**A check-in**: one regular look at everything you care about, which stays quiet unless
something needs you.

* "Check in every 30 minutes, but never between 11pm and 7am."

GAIA confirms each one with you before it sets it up.

> [!TIP]
>
> Alerts about email, like "tell me if anything urgent lands in my inbox", need your mail
> account connected first, under **Settings → Connectors** in the GAIA app.

## Seeing and changing them

Just ask:

* "What are you watching?"
* "Pause the check-in."
* "Check every hour instead."
* "Stop the Rainier alert."

GAIA finds the one you mean and confirms the change with you.

To see them all at once, open **Settings → Automations** in the GAIA app. Each one shows
what kind it is, how often it runs and when it runs next. **Pause** stops it until you
**Resume** it, and **Remove** deletes it after you confirm. These buttons take effect at
once, because clicking them is already your decision. To add an automation or change
what it does, ask GAIA in chat. GitHub watches you set up from Discord aren't on this
screen; ask GAIA "what are you watching?" to see or stop them.

In the terminal app, type `/automations` for the same numbered list. Then
`/automations pause 2`, `/automations resume 2` or `/automations remove 2` changes the
second one. Its name works in place of the number.

## Good to know

* **Your PC has to be on.** Nothing runs while it's off or asleep. When it wakes, anything
  that came due runs once, not once for every time it missed.
* **They run whenever GAIA does.** GAIA's background service runs them, so they keep going
  while GAIA's Discord connection is stopped. What comes due then waits and reaches your
  DM, marked late, as soon as the connection is back. A repeating one that came due
  several times arrives once. "What are you watching?" lists anything still waiting, and
  stopping or pausing an automation cancels what was waiting for it.
* **Nothing is lost while Discord isn't set up.** Until it is connected, what comes due
  just waits and runs once it is.
* **Quiet hours wait.** A check due at night runs when the quiet hours end, so nothing
  wakes you at 3am.
* **They still ask first.** If an automation needs to change something on your PC, you get
  the same **Allow / Deny** message as when you ask GAIA yourself.
* You can have up to 25 automations, and a repeating one runs at most every 5 minutes.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.