> For the complete documentation index, see [llms.txt](https://bluebricks.co/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://bluebricks.co/docs/readme.md).

# Welcome to the Bluebricks Docs

## Get started

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th data-hidden data-card-cover data-type="image">Cover image</th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-type="image">Cover image (dark)</th><th data-hidden data-card-cover-dark data-type="image">Cover image (dark)</th></tr></thead><tbody><tr><td><strong>What is Bluebricks?</strong><br>Connect your cloud and code, and AI agents manage your infrastructure</td><td><a href="/files/JkOdUJWNMv9QhOj6XAlH">/files/JkOdUJWNMv9QhOj6XAlH</a></td><td><a href="/pages/uQ4ThrIXevNrGTnyFOtf">/pages/uQ4ThrIXevNrGTnyFOtf</a></td><td><a href="/files/ezBIKVCFYdnzOJpqfjEn">/files/ezBIKVCFYdnzOJpqfjEn</a></td><td><a href="/files/ezBIKVCFYdnzOJpqfjEn">/files/ezBIKVCFYdnzOJpqfjEn</a></td></tr><tr><td><strong>Quick Start</strong><br>Connect your cloud, connect your code, talk to the agents</td><td><a href="/files/Oii1eInKRp3Gm1sKdNiN">/files/Oii1eInKRp3Gm1sKdNiN</a></td><td><a href="/pages/fhySk0QfJ6JyM4apdFO3">/pages/fhySk0QfJ6JyM4apdFO3</a></td><td></td><td><a href="/files/VwgIsxRWHGnlKTVkG4jX">/files/VwgIsxRWHGnlKTVkG4jX</a></td></tr></tbody></table>

## Meet the agent

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th data-hidden data-card-cover data-type="image">Cover image</th><th data-hidden data-card-cover-dark data-type="image">Cover image (dark)</th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>How the Agent Works</strong><br>Context layer, capabilities, and how the agent reasons about your infrastructure</td><td><a href="/files/LbNB9xcWR0CTuw1d4f9r">/files/LbNB9xcWR0CTuw1d4f9r</a></td><td><a href="/files/vV04DswhK48qTcnHhU3k">/files/vV04DswhK48qTcnHhU3k</a></td><td><a href="/pages/7KYjmGpkS1gNkCUG6int">/pages/7KYjmGpkS1gNkCUG6int</a></td></tr><tr><td><strong>Codifying Infrastructure</strong><br>Import existing cloud resources into code through the agent</td><td><a href="/files/X9VSLcwICG4QR02K6YIn">/files/X9VSLcwICG4QR02K6YIn</a></td><td><a href="/files/QQZY5LkcdbjYgbD90T4b">/files/QQZY5LkcdbjYgbD90T4b</a></td><td><a href="/pages/x3iM4t1mLZSJhnumzB2R">/pages/x3iM4t1mLZSJhnumzB2R</a></td></tr></tbody></table>

## Orchestration

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-cover data-type="image">Cover image</th><th data-hidden data-card-cover-dark data-type="image">Cover image (dark)</th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Collections</strong><br>Group cloud accounts, teams, and stages into governed deployment targets</td><td><a href="/files/eY5MTcwAfTCvrW3m8Es8">/files/eY5MTcwAfTCvrW3m8Es8</a></td><td><a href="/files/GpWZt2AV8tYf9WPsxnKT">/files/GpWZt2AV8tYf9WPsxnKT</a></td><td><a href="/pages/qG3yaaK8VRr4iqJJcP8O">/pages/qG3yaaK8VRr4iqJJcP8O</a></td></tr><tr><td><strong>Packages</strong><br>Reusable, versioned building blocks for your infrastructure code</td><td><a href="/files/3JCUIocCFprTBesHxbqm">/files/3JCUIocCFprTBesHxbqm</a></td><td><a href="/files/FLXLavkvvfXXQVXOD2qG">/files/FLXLavkvvfXXQVXOD2qG</a></td><td><a href="/pages/RaVuz2bcyctXGY0ErjIj">/pages/RaVuz2bcyctXGY0ErjIj</a></td></tr><tr><td><strong>Environments</strong><br>Deploy blueprints into collections with governed plan/approve/apply workflows</td><td><a href="/files/GqKhkUbazM74ydFcYd01">/files/GqKhkUbazM74ydFcYd01</a></td><td><a href="/files/G2C3X2Mb9Cu9pHrluK80">/files/G2C3X2Mb9Cu9pHrluK80</a></td><td><a href="/pages/r726FnxiQB0aReq5Y3fY">/pages/r726FnxiQB0aReq5Y3fY</a></td></tr></tbody></table>

## Tools

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-cover data-type="image">Cover image</th><th data-hidden data-card-cover-dark data-type="image">Cover image (dark)</th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Bricks CLI</strong><br>Run, plan, and ship infrastructure from the terminal</td><td><a href="/files/NUPnECfFlrg1xZjdCI03">/files/NUPnECfFlrg1xZjdCI03</a></td><td><a href="/files/4fBEsfewZTymxFS8lw4c">/files/4fBEsfewZTymxFS8lw4c</a></td><td><a href="/pages/dntQmowfGi50XVJh7dBJ">/pages/dntQmowfGi50XVJh7dBJ</a></td></tr><tr><td><strong>API Overview</strong><br>Automate Bluebricks at scale with the REST API</td><td><a href="/files/MjQujUdHvop6x9jzgaFs">/files/MjQujUdHvop6x9jzgaFs</a></td><td><a href="/files/ZjEsPHy6atTynIJahZmm">/files/ZjEsPHy6atTynIJahZmm</a></td><td><a href="/spaces/qHXqMr0KYQT5OUP6gSt0">/spaces/qHXqMr0KYQT5OUP6gSt0</a></td></tr><tr><td><strong>GitOps Environments</strong><br>Keep your cloud in sync with your code through Git-driven workflows</td><td><a href="/files/cphqxpLv9RDJgR3ULoeE">/files/cphqxpLv9RDJgR3ULoeE</a></td><td><a href="/files/pBhYzJ6oNGcrsqNvsEas">/files/pBhYzJ6oNGcrsqNvsEas</a></td><td><a href="/pages/dEO0qG5EiBiMxvwfKOPo">/pages/dEO0qG5EiBiMxvwfKOPo</a></td></tr></tbody></table>

## Integrations

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>GitHub</strong><br>Connect repositories, get plan check runs on PRs, and manage IaC from GitHub</td><td><a href="/pages/ZjFncA7RfSvqcjTpDfLr">/pages/ZjFncA7RfSvqcjTpDfLr</a></td></tr><tr><td><strong>GitLab</strong><br>Run Bricks CLI commands inside GitLab CI/CD pipelines</td><td><a href="/pages/NopIjRq6X4EauFLP9AO4">/pages/NopIjRq6X4EauFLP9AO4</a></td></tr><tr><td><strong>Slack</strong><br>Get notifications and interact with the Bluebricks agent in Slack</td><td><a href="/pages/BbLL8HAiAWS8pYAPUPSE">/pages/BbLL8HAiAWS8pYAPUPSE</a></td></tr><tr><td><strong>Backstage</strong><br>Provision environments and browse blueprints from your developer portal</td><td><a href="/pages/OXD6ZORIrhEb7L0B5v6S">/pages/OXD6ZORIrhEb7L0B5v6S</a></td></tr><tr><td><strong>GitHub Actions</strong><br>Run Bricks CLI commands in your GitHub Actions workflows</td><td><a href="/pages/nHDI12oeJrmpNRy2O7ZM">/pages/nHDI12oeJrmpNRy2O7ZM</a></td></tr><tr><td><strong>Azure DevOps</strong><br>Integrate Bluebricks into your Azure DevOps pipelines</td><td><a href="/pages/FA37rJc4k8vP4A6SbahG">/pages/FA37rJc4k8vP4A6SbahG</a></td></tr></tbody></table>