# Bellows

> Run a coding agent against your repository, inside guardrails your engineers define.

- [Introduction](https://docs.bellows.cloud/overview/introduction.md): Product teams drive change. Engineers define the guardrails. Bellows does the work.
- [Quickstart](https://docs.bellows.cloud/overview/quickstart.md): Connect a repo, describe a change, review the pull request Bellows opens.
- [Core concepts](https://docs.bellows.cloud/overview/concepts.md): The words you'll meet in the app, the CLI and these docs.
- [Run tasks](https://docs.bellows.cloud/guides/run-tasks.md): Create, steer and finish tasks in the web app.
- [Task lifecycle](https://docs.bellows.cloud/guides/task-lifecycle.md): What each task status means, what moves a task between them, and what to do when a run fails.
- [Writing good tasks](https://docs.bellows.cloud/guides/writing-good-tasks.md): The agent knows your code only through the repo and your words. Be specific about the outcome and how to verify it.
- [Attachments](https://docs.bellows.cloud/guides/attachments.md): Attach screenshots, PDFs and other files to a task or follow-up so the agent can work from them.
- [Fix a bug from a Jira ticket](https://docs.bellows.cloud/use-cases/fix-jira-bug.md): Point a task at a Jira ticket and get a pull request with a failing test, the fix and green gates.
- [Add tests to a package](https://docs.bellows.cloud/use-cases/add-tests.md): Raise test coverage for one package or endpoint, with gates that prove the new tests run and pass.
- [Upgrade a dependency](https://docs.bellows.cloud/use-cases/upgrade-dependencies.md): Bump one Go module or npm package, fix what breaks, and let build, test and lint gates prove the upgrade.
- [Drive Bellows from Claude Code](https://docs.bellows.cloud/use-cases/drive-from-claude-code.md): Start, watch and finish Bellows tasks from your terminal while you keep coding locally.
- [Configure your repo](https://docs.bellows.cloud/guides/configure-repo.md): .bellows.yaml sets where the agent works and what “done” means.
- [Gates](https://docs.bellows.cloud/guides/gates.md): Gates are the commands in .bellows.yaml that decide whether the agent's work counts as done.
- [Services](https://docs.bellows.cloud/guides/services.md): Run sidecar containers such as Postgres or Redis next to the agent so integration tests have something to talk to.
- [Policy and reviewers](https://docs.bellows.cloud/guides/policy-and-reviewers.md): Require passing gates or an independent review before Bellows publishes a task's work, and define the reviewers the agent can call.
- [Executors](https://docs.bellows.cloud/guides/executors.md): Choose and configure the coding agent that runs your tasks.
- [Skills](https://docs.bellows.cloud/guides/skills.md): Give the agent reusable playbooks, and call them from a task with a slash.
- [Environment variables and secrets](https://docs.bellows.cloud/guides/env-and-secrets.md): Give the runner the values it needs, such as API keys and feature flags, at the organization, workspace or repository level.
- [Connections](https://docs.bellows.cloud/guides/connections.md): What Bellows connects to, what each connection lets tasks do, and how to set it up.
- [Install and sign in](https://docs.bellows.cloud/cli/install.md): Install the bellows CLI, point it at your Bellows server with a personal token, and check that it works.
- [Command reference](https://docs.bellows.cloud/cli/commands.md): Every bellows command and flag, with examples for creating, waiting on and following up tasks.
- [Connect an MCP client](https://docs.bellows.cloud/mcp/connect.md): Drive Bellows from Claude Code, Claude.ai or any MCP client, acting as you.
- [MCP tools](https://docs.bellows.cloud/mcp/tools.md): Every tool the Bellows MCP server offers, grouped by what you want to do.
- [Self-hosting overview](https://docs.bellows.cloud/self-host/overview.md): What runs when you host Bellows yourself, how a task moves through it, and what you need before you start.
- [Docker Compose](https://docs.bellows.cloud/self-host/docker-compose.md): Run Bellows on one machine with the Docker executor, from clone to first task.
- [Kubernetes and Helm](https://docs.bellows.cloud/self-host/kubernetes.md): Install Bellows on a Kubernetes cluster with the Helm chart, try it on kind, and run it in production.
- [Create the GitHub App](https://docs.bellows.cloud/self-host/github-app.md): Register the GitHub App and OAuth App that Bellows needs to sign people in, read repositories and open pull requests.
- [Set up Jira](https://docs.bellows.cloud/self-host/jira-app.md): Register an Atlassian OAuth app so people on your Bellows install can connect Jira.
- [Server and driver configuration](https://docs.bellows.cloud/self-host/configuration.md): Every environment variable the Bellows server and driver read, with defaults and what each one does.
- [Security model](https://docs.bellows.cloud/self-host/security.md): What Bellows isolates, what an agent can reach, how secrets and tokens are handled, and where the limits are.
- [.bellows.yaml reference](https://docs.bellows.cloud/reference/bellows-yaml.md): Every key, type, default, limit and error of the .bellows.yaml file at the root of your repository.
- [Limits](https://docs.bellows.cloud/reference/limits.md): Every user-visible limit in Bellows, grouped by area, with what happens when you go over it.
- [Glossary](https://docs.bellows.cloud/reference/glossary.md): Every term you meet in the Bellows app, CLI and docs, in alphabetical order.
- [FAQ and troubleshooting](https://docs.bellows.cloud/reference/faq.md): Quick answers to common questions, and a symptom-to-fix guide for the failures you are most likely to see.
- [Changelog](https://docs.bellows.cloud/reference/changelog.md): What changed in each Bellows release, in plain words.


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