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

# Introduction

> Product teams drive change. Engineers define the guardrails. Bellows does the work.

Bellows runs a coding agent against your repository on a cluster. Every run happens inside a container you define. It must pass the checks you define. Its result is a pull request you review.

## Ways to use Bellows

> [card] [Web app](https://docs.bellows.cloud/guides/run-tasks.md)
>
> Write tasks, answer the agent's questions and review results in the browser.

> [card] [CLI](https://docs.bellows.cloud/cli/install.md)
>
> `bellows job create`: script tasks from your terminal or CI.

> [card] [MCP server](https://docs.bellows.cloud/mcp/connect.md)
>
> Drive Bellows from Claude Code, Claude.ai or any MCP client.

## Cloud or self-hosted

| | Bellows Cloud | Self-hosted |
| - | - | - |
| Setup | Sign in with GitHub, pick repos | Postgres, a GitHub App, Docker or Kubernetes |
| Runners | Managed | Your cluster (Helm chart) |
| Best for | Trying Bellows, most teams | Strict data residency, custom infra |

> [!NOTE]
>
> These docs follow the Cloud path. To run Bellows yourself, see [Self-hosting](https://docs.bellows.cloud/self-host/overview.md).

## How it fits together

| Part | What it does |
| - | - |
| **Server** | Stores tasks and serves the web app, the API and the MCP endpoint |
| **Driver** | Picks up queued jobs and starts a runner for each one |
| **Runner** | The container your repo's `.bellows.yaml` describes. The agent works and the gates run here |
| **Executor** | The coding agent: Claude Code, OpenCode or a custom profile built on them |

## Next steps

> [card] [Quickstart](https://docs.bellows.cloud/overview/quickstart.md)
>
> From a repo to your first pull request in about 10 minutes.

> [card] [Core concepts](https://docs.bellows.cloud/overview/concepts.md)
>
> Tasks, jobs, gates, skills: the words you'll meet.


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