# 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>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://bluebricks.co/docs/readme.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.