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

# Schedule triggers

> Run an agent automatically on a recurring schedule — hourly, daily, weekly, or monthly.

A schedule trigger runs an agent automatically on a recurring schedule, with a fixed input you define when you create the trigger.

<Note>
  In the CLI and REST API, schedule triggers are referred to as `time` triggers. `--type time` is the value you pass when creating one.
</Note>

## Frequencies

| Frequency | Options                    |
| --------- | -------------------------- |
| `HOURLY`  | —                          |
| `DAILY`   | Time of day                |
| `WEEKLY`  | Days of week, time of day  |
| `MONTHLY` | Days of month, time of day |

## Create a schedule trigger

<Steps>
  <Step title="Open your workspace">
    Go to [guild.ai](https://guild.ai) and open the workspace where the agent is installed.
  </Step>

  <Step title="Go to Triggers">
    In the left sidebar, open **More** and click **Triggers**, then click **New trigger**.
  </Step>

  <Step title="Configure the schedule">
    Select **Schedule**, choose a frequency, and set the time of day (and days of week or month, if applicable).
  </Step>

  <Step title="Select an agent and input">
    Choose the agent the trigger will run, and define the fixed input it receives each time the trigger fires.
  </Step>
</Steps>

### With the CLI

```bash theme={null}
# Daily trigger at 9:00 AM
guild trigger create \
  --type time \
  --frequency DAILY \
  --time 09:00 \
  --agent daily-report \
  --input '{"project": "GUILD"}'

# Weekly trigger on Monday mornings
guild trigger create \
  --type time \
  --frequency WEEKLY \
  --days-of-week monday \
  --time 09:00 \
  --agent weekly-summary

# Monthly trigger on the 1st of the month
guild trigger create \
  --type time \
  --frequency MONTHLY \
  --days-of-month 1 \
  --time 09:00 \
  --agent monthly-report
```

## Agent input

Define the input the agent receives each time the trigger fires. Open the **Edit Trigger** dialog to edit it.

On desktop, a schema-driven panel appears on the right side of the dialog, driven by the selected agent's input schema. On mobile, a text field appears instead.

## Update a schedule trigger

```bash theme={null}
guild trigger update <trigger-id> --time 10:00
```

See [Manage triggers](/platform/triggers#manage-triggers) for activating, deactivating, listing, and inspecting triggers of any type.