Skip to main content

Examples

Explore Atmos example projects with stack configurations, components, and workflows

ai

Use AI to chat with your infrastructure, inspect stacks and components, and analyze command output.

ai-claude-code

Use your Claude Pro/Max subscription instead of API tokens. Claude Code manages the AI

auth-stores

Demonstrates how stores authenticate using Atmos auth identities instead of the default credential chain.

aws-security-compliance

Analyze AWS security findings, map them to Atmos components and stacks, and get

caching

This example demonstrates the Terraform registry cache — transparent **provider and

compositions

A composition groups multiple services into one system. Components declare

config-profiles

This example demonstrates Atmos config profiles - a powerful feature for managing environment-specific configurations without duplicating settings across your infrastructure.
Stacks

container-component

This example demonstrates the container component kind: stack-scoped,

container-sandbox

Run an entire Atmos workflow inside one shared container sandbox.

container-step

Build, push, and run containers from Atmos workflows and custom commands.

custom-commands

This example demonstrates how to extend Atmos with custom CLI commands, making it easier for teams to use your toolchain through a single, consistent interface.
Automation

custom-components

This example demonstrates how to define custom component types in Atmos using custom commands.
Components

demo-ansible

Minimal Atmos setup demonstrating how stack variables are passed to Ansible playbooks.
Automation

demo-atlantis

Generate Atlantis configuration for PR-based Terraform automation.
Automation

demo-auth

This demo showcases how to structure an Atmos project with an auth section in atmos.yaml. Please see the Atmos docs for more information.
Stacks

demo-component-versions

Pin components to specific versions for reproducible deployments.
Components

demo-context

Inspect how Atmos resolves configuration from multiple sources.
Stacks

demo-env

This example demonstrates how to use atmos env to export environment variables
Stacks

demo-floci

This example provisions an S3 bucket against Floci, a free, MIT-licensed AWS emulator that is a drop-in replacement for LocalStack Community Edition (which was EOL...
DX

demo-helmfile

Deploy Kubernetes resources using Helmfile with Atmos stack patterns.
DX

demo-library

Here are some examples of distributing reusable components as part of a library.
Components

demo-schemas

Validate stack configuration against JSON Schema before running Terraform.
Stacks

demo-stacks

Inherit configuration across environments to eliminate duplication.
Stacks

demo-vendoring

Pull Terraform modules from GitHub, S3, or OCI registries with pinned versions.
Components

demo-workflows

Run multiple Atmos commands in sequence with a single command.
Automation

devcontainer

This example demonstrates how to configure devcontainers in Atmos as a replacement for the Geodesic shell wrapper.
DX

devcontainer-build

This example demonstrates using a custom Dockerfile with Atmos devcontainers. The Dockerfile extends the Geodesic base image and pre-installs Atmos.
DX

generate-files

This example demonstrates how to use atmos terraform generate files to generate an entire Terraform component from stack configuration.
Automation

gitops

This example shows the publishing half of a GitOps pipeline — reconcile, review, and publish artifacts to a managed deployment repository using atmos git. A reconciler such as Argo CD or Flux (o...

hooks-checkov

Demonstrates the checkov hook kind: an after.terraform.plan hook

hooks-custom-command

Demonstrates the generic kind: command hook by wiring a custom

hooks-infracost

Demonstrates the infracost hook kind: an after.terraform.plan hook

hooks-kics

Demonstrates the kics hook kind: an after.terraform.plan hook that

hooks-trivy

Demonstrates the trivy hook kind: an after.terraform.plan hook that

http-webhooks

This example demonstrates the http workflow step type, which performs an HTTP

interactive-workflows

This example demonstrates Atmos's powerful interactive workflow step types. These step types enable building sophisticated CLI wizards and interactive deployment pipelines.
Automation

locals

Reduce repetition and build computed values using file-scoped locals.

mcp

Connect Atmos to external MCP servers from the AWS ecosystem. Their tools become available

mcp-for-ai-coding-assistants

Configure MCP servers (Atmos MCP server plus the

native-terraform

This example demonstrates migrating from native Terraform (with .tfvars files) to Atmos.

onepassword-secrets

Declarative secrets backed by 1Password, resolved with the

quick-start-advanced

Atmos is a universal tool for DevOps and cloud automation. It allows
Quickstart

quick-start-simple

Minimal Atmos setup with a single component and three environments.
Quickstart

remote-stack-imports

This example demonstrates how to import stack configurations from remote sources using go-getter URL schemes.

say-something

This example demonstrates the say step type in custom commands, workflows,

secrets-masking

This example demonstrates Atmos's automatic secrets masking feature.

sops-secrets

Atmos declarative secrets management end to end with a SOPS backend (age encryption) — the
Stacks

source-provisioning

Demonstrates JIT (Just-in-Time) source provisioning from both local and remote sources.
Components

stack-names

This example demonstrates imperative stack naming using the name field in stack manifests.
Stacks

toolchain

Configure tool registries and use toolchain-managed tools in custom commands and workflows.
DX

workflow-retries

Demonstrates automatic retry configuration for workflow steps.