> 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 an overview of Bluebricks' core concepts, tools, and how they work together

## 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="https://454695563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL1aVoJ67VgVl8Uv83TuE%2Fuploads%2Fsj0sNcXR3DeCF03DwCZk%2Fwhat%20is%20bluebricks%20light.png?alt=media&amp;token=13bac6b1-b295-470e-ac7d-9c41a7a2533e">what is bluebricks light.png</a></td><td><a href="/docs/getting-started/building-blocks.md">What is Bluebricks?</a></td><td><a href="https://454695563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL1aVoJ67VgVl8Uv83TuE%2Fuploads%2FYnsJ3WIpWCt5HO2w0PCE%2Fwhat%20is%20bluebricks%20dark.png?alt=media&amp;token=452384b5-1701-4322-be67-b668d367d428">what is bluebricks dark.png</a></td><td><a href="https://454695563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL1aVoJ67VgVl8Uv83TuE%2Fuploads%2FYnsJ3WIpWCt5HO2w0PCE%2Fwhat%20is%20bluebricks%20dark.png?alt=media&amp;token=452384b5-1701-4322-be67-b668d367d428">what is bluebricks dark.png</a></td></tr><tr><td><strong>Quick Start</strong><br>Connect your cloud, connect your code, talk to the agents</td><td><a href="https://454695563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL1aVoJ67VgVl8Uv83TuE%2Fuploads%2FYA9ZUL5lKj3JvCWjxNUY%2FQuick%20Start%20light.png?alt=media&amp;token=6ce2a5d3-01ee-4d1d-85f0-780259eb62f1">Quick Start light.png</a></td><td><a href="/docs/getting-started/quick-start.md">Quick Start</a></td><td></td><td><a href="https://454695563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL1aVoJ67VgVl8Uv83TuE%2Fuploads%2FRESwdrd8T6v6O2nrpgEg%2FQuick%20Start%20dark.png?alt=media&amp;token=fdaf58b8-69a7-4e30-8ea4-c140e2329079">Quick Start dark.png</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="https://454695563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL1aVoJ67VgVl8Uv83TuE%2Fuploads%2Fgit-blob-30846b8d907c998556fd2b6a9e5041083abe11f3%2FHow%20the%20agent%20works%20-%20light.png?alt=media">How the agent works - light.png</a></td><td><a href="https://454695563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL1aVoJ67VgVl8Uv83TuE%2Fuploads%2Fgit-blob-b9f539b77e4f5cb4a45c778330efb40d7d14db69%2FHow%20the%20agent%20works%20-%20dark.png?alt=media">How the agent works - dark.png</a></td><td><a href="/docs/agent/agents-overview.md">Agent Overview</a></td></tr><tr><td><strong>Codifying Infrastructure</strong><br>Import existing cloud resources into code through the agent</td><td><a href="https://454695563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL1aVoJ67VgVl8Uv83TuE%2Fuploads%2Fgit-blob-20c150f2e48d01583ca3935e4893047b6f95c15f%2FCodifying%20Infrastructure%20light.png?alt=media">Codifying Infrastructure light.png</a></td><td><a href="https://454695563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL1aVoJ67VgVl8Uv83TuE%2Fuploads%2Fgit-blob-aa24ecec7ae13cd560d6e7fff4f06d6a70a5a13a%2FCodifying%20Infrastructure%20dark.png?alt=media">Codifying Infrastructure dark.png</a></td><td><a href="/docs/agent/codifying-infrastructure.md">Codifying Infrastructure</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="https://454695563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL1aVoJ67VgVl8Uv83TuE%2Fuploads%2F58jJtWsUBBovyIBOiJoU%2Fimage.png?alt=media&amp;token=fba49bfd-0923-41e0-8220-b3156043953b">image.png</a></td><td><a href="https://454695563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL1aVoJ67VgVl8Uv83TuE%2Fuploads%2FrVRdcMTf8nTIx3BtZRU6%2Fimage.png?alt=media&amp;token=218634c8-52f2-4ef0-aa67-8174a4f2197b">image.png</a></td><td><a href="/docs/orchestration/collections.md">Collections</a></td></tr><tr><td><strong>Packages</strong><br>Reusable, versioned building blocks for your infrastructure code</td><td><a href="https://454695563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL1aVoJ67VgVl8Uv83TuE%2Fuploads%2FeqLMCpo4YS6vMBSTdPQf%2Fimage.png?alt=media&amp;token=a44920f5-98b9-4fe4-9553-36efed6371c9">image.png</a></td><td><a href="https://454695563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL1aVoJ67VgVl8Uv83TuE%2Fuploads%2FrggOt4jR7QR3E9BRVRlM%2Fimage.png?alt=media&amp;token=85164da8-eeea-4886-b23c-9cdb92c761ba">image.png</a></td><td><a href="/docs/orchestration/packages.md">Packages</a></td></tr><tr><td><strong>Environments</strong><br>Deploy blueprints into collections with governed plan/approve/apply workflows</td><td><a href="https://454695563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL1aVoJ67VgVl8Uv83TuE%2Fuploads%2Fhxyv9Iz8iirKnhja8imq%2Fimage.png?alt=media&amp;token=142b3427-91a5-4de6-825e-6be425fa23f4">image.png</a></td><td><a href="https://454695563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL1aVoJ67VgVl8Uv83TuE%2Fuploads%2Fo8CWi9ar6esUgbHbLGoj%2Fimage.png?alt=media&amp;token=b0613cce-4d38-42a8-9faf-390572ffdfcd">image.png</a></td><td><a href="/docs/orchestration/environments.md">Environments</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="https://454695563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL1aVoJ67VgVl8Uv83TuE%2Fuploads%2FRNjAfd7n4475I9qBBcaL%2Fimage.png?alt=media&amp;token=46bbdbb0-ac8a-4667-9b05-594d48eb7fbf">image.png</a></td><td><a href="https://454695563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL1aVoJ67VgVl8Uv83TuE%2Fuploads%2F4Pc9fdgtMWsjUOvFIIfZ%2Fimage.png?alt=media&amp;token=28d7ca17-89c2-4b05-80f4-ab3da71c8074">image.png</a></td><td><a href="/docs/bricks-cli/bricks-cli.md">Bricks CLI Overview</a></td></tr><tr><td><strong>API Overview</strong><br>Automate Bluebricks at scale with the REST API</td><td><a href="https://454695563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL1aVoJ67VgVl8Uv83TuE%2Fuploads%2Fy34wq3aA8oXfIJqhr77O%2Fimage.png?alt=media&amp;token=0cfb8581-7205-4428-b984-4d1798d923da">image.png</a></td><td><a href="https://454695563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL1aVoJ67VgVl8Uv83TuE%2Fuploads%2FDsOvQlx42jhdu2ORAyWv%2Fimage.png?alt=media&amp;token=fa05b640-1ea7-4667-983d-4bed9b875607">image.png</a></td><td><a href="https://bluebricks.co/docs/api/">API references</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="https://454695563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL1aVoJ67VgVl8Uv83TuE%2Fuploads%2FUCCiKL7fdn9DpJl7Oyq3%2Fgitops%20env%20light.png?alt=media&amp;token=08e64765-e82a-4f14-a2f3-236f2b3320a9">gitops env light.png</a></td><td><a href="https://454695563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL1aVoJ67VgVl8Uv83TuE%2Fuploads%2FBPYsWz8mhX9Avix3EIy5%2Fgitops%20env%20dark.png?alt=media&amp;token=6e66aa2a-66ac-49f7-b6a7-90f8c197b393">gitops env dark.png</a></td><td><a href="/docs/orchestration/environments/gitops-environments.md">GitOps Environments</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="/docs/integrations/github.md">Github</a></td></tr><tr><td><strong>GitLab</strong><br>Run Bricks CLI commands inside GitLab CI/CD pipelines</td><td><a href="/docs/integrations/gitlab.md">GitLab</a></td></tr><tr><td><strong>Slack</strong><br>Get notifications and interact with the Bluebricks agent in Slack</td><td><a href="/docs/integrations/slack.md">Slack</a></td></tr><tr><td><strong>Backstage</strong><br>Provision environments and browse blueprints from your developer portal</td><td><a href="/docs/integrations/backstage.md">Backstage</a></td></tr><tr><td><strong>GitHub Actions</strong><br>Run Bricks CLI commands in your GitHub Actions workflows</td><td><a href="/docs/integrations/githubactions.md">Github Actions</a></td></tr><tr><td><strong>Azure DevOps</strong><br>Integrate Bluebricks into your Azure DevOps pipelines</td><td><a href="/docs/integrations/azure-devops.md">Azure DevOps</a></td></tr></tbody></table>
