---
title: "Create & run an automation"
description: "Set up an autonomous loop that runs on a schedule and opens pull requests between sessions."
---

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

# Create & run an automation

An [automation](/concepts/automations) runs an agent against a repository on a
schedule, without anyone present. Use it for recurring maintenance or any goal
you want chipped away at over time. This guide sets one up.

1. **Create the automation**

   Choose **New automation** and fill in:

- **Name** (and an optional **Description**).
- **Instructions** — the prompt the agent runs each time.
- **Repository** and an optional **base branch**.
- **Blueprint** — the workflow to follow — and an optional **Model**.
- **Environment variables** and **Secrets** if the run needs them.

2. **Add a schedule**

   Add one or more schedules. For each, pick a **type** — **Hourly**, **Daily**, or
   **Monthly** — set the time (hour and minute for daily; day-of-month for monthly),
   and choose a **timezone**. You can add several schedules to one automation.

3. **Run it**

   Save the automation. It will run at the next scheduled time — or choose
   **Trigger now** to run it immediately. Use **Pause** / **Enable** to turn the
   schedule off and on; the automation shows its **next run** (or **Paused**).

4. **Review the runs**

   Each run appears in the automation's **run history**. Every run is a
   [task/implementation](/concepts/tasks): it follows the blueprint's steps in a
   sandbox and opens a pull request you review — see
   [Review implementations](/guides/reviewing-implementations).

> **Keep instructions focused**
>
> Automations run unattended and repeatedly. A tight, well-scoped instruction
> produces more predictable pull requests than a broad one.

Source: https://docs.trevize.dev/guides/automations/index.mdx