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

# Scheduled agents

> Agents-as-files that run on a schedule to keep your site alive, versioned in git alongside your code.

Scheduled agents are Fimo's way of keeping a site fresh without a human in the loop. An agent is a small **bundle of committable files** in your repo — you deploy it like the rest of your code, then wire it to a trigger so it runs on its own.

Because the definition lives in git, an agent is reviewable, diffable, and portable. The cloud only holds the *activations* (which triggers are wired on which environment) and the *run history*.

## What an agent is

Every agent lives under `agents/<name>/` in your project:

* **`config.yaml`** — triggers, requested secrets, and an integration allowlist.
* **`GOAL.md`** — what the agent should accomplish, in plain language.
* Optional files such as `capabilities.yaml` for composed sub-agents.

Omitted integrations and tools are simply unavailable to the agent, so the allowlist is your safety boundary.

## Why they matter

<Columns cols={2}>
  <Card title="Autonomous upkeep" icon="arrows-rotate">
    Translate new content, sweep for broken links, or run a post-deploy check — on a cron, unattended.
  </Card>

  <Card title="Versioned like code" icon="code-branch">
    The bundle reaches the server through `fimo deploy`, so agents branch, review, and roll back with everything else.
  </Card>

  <Card title="Scoped by design" icon="shield-halved">
    An explicit integration and tool allowlist means an agent can only touch what you grant it.
  </Card>

  <Card title="Inspectable runs" icon="list-check">
    Every run records a report and history you can read back from the CLI.
  </Card>
</Columns>

<Note>
  The bundle lives in **git**, not the database. Editing an agent locally is not enough — run `fimo deploy` to push the bundle before you activate or run it.
</Note>

## What's next

<Columns cols={3}>
  <Card title="Create an agent" icon="plus" href="/docs/agents/create">
    Scaffold a bundle from a template, write its goal, and validate it.
  </Card>

  <Card title="Schedules" icon="calendar" href="/docs/agents/schedules">
    Wire an agent to a cron trigger and trigger runs on demand.
  </Card>

  <Card title="Runs, reports & logs" icon="list-check" href="/docs/agents/runs">
    Inspect what an agent did on each run.
  </Card>
</Columns>