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

# Background automations

> Proactive background agents that combine AI prompts with deterministic commands in trigger-based, closed-loop workflows.

Automations are background agents that run in the cloud. They combine AI prompts with deterministic commands to deliver merge-ready pull requests triggered manually, on a schedule, on pull request events, or via webhooks.

![Automations page](https://mintcdn.com/gitpod-13c83c2b/4vgXCiQwLDATxcBd/images/automations/create-automation-landing.png?fit=max\&auto=format\&n=4vgXCiQwLDATxcBd\&q=85\&s=481ff63df36571a9f377c58883840e14)

> [!TIP]
>
> Automations work best with [projects](https://ona.com/docs/ona/projects/overview.md). A project provides the Dev Container configuration, pre-installed dependencies, and environment settings that every Automation run uses. Set up a [project](https://ona.com/docs/ona/create-first-project.md) first, then build Automations on top of it.

## How Automations work

Every Automation follows a closed-loop workflow:

1. **Trigger**: run manually, on PR events, on a schedule, or via webhook.
2. **Execute**: Ona clones, branches, installs, builds, tests, iterates, commits, pushes, and opens a PR. The same loop a human engineer runs, except Automations can do it across hundreds of repos in parallel.
3. **Review**: inspect outputs, logs, and linked PRs. Approve and merge when satisfied.

Every Automation runs in a fully configured environment defined by `devcontainer.json` and `.ona/config.yaml`. Dependencies install, services start, tools are available. Not a minimal CI runner, but a full development environment.

![Automation execution dashboard](https://mintcdn.com/gitpod-13c83c2b/4vgXCiQwLDATxcBd/images/automations/overview_2.png?fit=max\&auto=format\&n=4vgXCiQwLDATxcBd\&q=85\&s=fdcfbf6ab5da5f5ca2093544031e7dda)

For how Automations fit into the broader platform, see [Core Components](https://ona.com/docs/ona/understanding/core-components.md#automations).

## Runs in the cloud

Automations run in the background. Your laptop does not need to be on. Review results from your phone or iPad.

Enterprise customers can run Ona in their own network (AWS, GCP), giving Automations the same connectivity and context your engineers have: query databases, hit internal APIs, run the full test suite against staging without tunnels or exported secrets.

## Integrations

Ona has native integrations with [Linear](https://ona.com/docs/ona/integrations/configure-linear.md), [Sentry](https://ona.com/docs/ona/integrations/configure-sentry.md), [Notion](https://ona.com/docs/ona/integrations/configure-notion.md), [Granola](https://ona.com/docs/ona/integrations/configure-granola.md), [GitHub, GitLab, and Atlassian](https://ona.com/docs/ona/integrations/configure-atlassian.md), giving Automations the same context and permissions your engineers have to read backlogs, triage issues, and open PRs.

Any [MCP server](https://ona.com/docs/ona/mcp.md) can be added as config-in-code via `.ona/mcp-config.json` in your repository.

## Use cases

Get started with a template or [build your own from scratch](https://ona.com/docs/ona/automations/configure-automations.md).

[Autonomous backlog pickerRuns daily. Picks your top Linear issue, implements it, runs tests, and opens a draft PR.Use template →](https://ona.com/templates/10x-engineer)

[Sentry error triage and fixTriages new Sentry issues, traces them to source, applies fixes, and opens PRs.Use template →](https://ona.com/templates/sentry-error-triage-and-fix)

[CVE remediationRuns security scans, resolves CVEs, reruns until clean, and creates standardized PRs.Use template →](https://ona.com/templates/cve-mitigation-dependency-updates)

[Scan recent commits for bugsScans recent commits for likely bugs and proposes minimal fixes in a draft PR.Use template →](https://ona.com/templates/scan-recent-commits-for-bugs)

[Draft weekly release notesDrafts release notes from the week's merged PRs, grouped by category with summaries.Use template →](https://ona.com/templates/draft-weekly-release-notes)

[Daily standup generatorPulls Linear sprint data and git activity to post a formatted daily standup update.Use template →](https://ona.com/templates/daily-standup-generator)

See [Automations in practice](https://ona.com/docs/ona/automations/automations-in-practice.md) for detailed setup guides for each use case.

## Access

Automations are available on Core and Enterprise plans with [plan-based limits](https://ona.com/docs/ona/automations/plans-and-limits.md) on the number of Automations, concurrent actions, and features like webhooks.

Organization admins can [share Automations with individual users and groups](https://ona.com/docs/ona/automations/sharing-automations.md), allowing team members to run pre-built Automations without admin privileges.

## Related: Tasks and Services

Automations run across repositories at scale. For per-environment automation (database seeding, server startup, test commands), see [Tasks and Services](https://ona.com/docs/ona/configuration/tasks-and-services/overview.md). Tasks and Services are configured in `.ona/config.yaml` and run within individual environments.

## FAQ

> [accordion] Can I see Automation environments in the sidebar?
>
> No. Automation environments are isolated execution contexts, not interactive environments.

> [accordion] How should I iterate on an Automation?
>
> Test on one or a few repositories first. Review results, adjust steps, then scale up gradually.

> [accordion] Projects vs repositories: when to use which?
>
> **Projects**: repetitive tasks on known repositories, pull request triggers.
>
> **Repositories**: large-scale migrations across thousands of repos, fine-grained selection.

> [accordion] Where should I install packages?
>
> Always in your Dev Container configuration. Packages are then available for all steps, pre-installed for faster runs.

> [accordion] How do I integrate with external systems?
>
> Configure [MCP integrations](https://ona.com/docs/ona/mcp.md) in Settings > Integrations. These are then available to your Automations.

> [accordion] Can I pause an Automation without deleting it?
>
> Yes. Disable it from the three-dot menu in the list or the toggle on the details page. Disabled Automations retain their configuration and history but won't start new runs. See [Enable and disable](https://ona.com/docs/ona/automations/configure-automations.md#enable-and-disable).


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