Atmos CI

Configure Atmos native CI integration to automatically update commit statuses, create job summaries, and export plan results inside GitHub Actions.

Atmos has native CI integration that allows it to automatically operate inside GitHub Actions — updating commit statuses, creating job summaries, and exporting plan results. Configure the ci block in your atmos.yaml to enable these features.

atmos.yaml

ci:
  enabled: true
  output:
    enabled: true
  summary:
    enabled: true
  checks:
    enabled: true
    context_prefix: ""
    statuses:
      component: true
      add: true
      change: true
      destroy: true

Each sub-feature controls a specific CI integration:

output — When enabled, exports variables to $GITHUB_OUTPUT so downstream steps in your workflow can reference plan results (e.g., whether changes were detected).
summary — When enabled, writes a formatted plan summary to $GITHUB_STEP_SUMMARY, which GitHub renders directly on the workflow run page.
checks — When enabled, posts commit status checks to the pull request. The context_prefix lets you namespace the check names, and the statuses map controls which check types are reported: component for per-component status, and add, change, destroy for resource-level operation statuses.

Next: Configure GitHub Workflows

Create the GitHub Actions workflows that Atmos Pro dispatches to plan, apply, and detect drift on your infrastructure.

Configure Workflows Configure Atmos Stacks

Atmos Stacks Atmos Toolchain