Examples

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

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

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

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

This example shows how to start a long-running container service in the background,

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

A composition groups multiple services into one system. Components declare

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

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

Run an entire Atmos workflow inside one shared container sandbox.

Build, push, and run containers from Atmos workflows and 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.

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

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

Generate Atlantis configuration for PR-based Terraform automation.

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

Pin components to specific versions for reproducible deployments.

Inspect how Atmos resolves configuration from multiple sources.

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

Deploy Kubernetes resources using Helmfile with Atmos stack patterns, against a local Kubernetes emulator (k3s).

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

Validate stack configuration against JSON Schema before running Terraform.

Inherit configuration across environments to eliminate duplication.

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

Run multiple Atmos commands in sequence with a single command.

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

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

This example provisions an S3 bucket against a local AWS sandbox — no AWS account or

This example deploys a Helm release (nginx) to a local Kubernetes sandbox — no EKS, no

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

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

A minimal, credential-free example of a native Helm component. The chart lives in

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

Demonstrates the generic kind: command hook by wiring a custom

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

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

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

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

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

Deploy Kubernetes manifests with Atmos-native Kubernetes components against a local Kubernetes emulator (k3s).

Render and deploy Kustomize overlays with Atmos-native Kubernetes components against a local Kubernetes emulator (k3s).

Stand up an entire GitOps loop on your laptop — no GitHub account, no real

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

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

Configure MCP servers (Atmos MCP server plus the

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

Declarative secrets backed by 1Password, resolved with the

This example demonstrates parallel and matrix workflow control steps with needs, configurable output, and failure behavior.

Atmos is a universal tool for DevOps and cloud automation. This advanced

Minimal Atmos setup with a single component and three environments.

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

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

This example demonstrates Atmos's automatic secrets masking feature.

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

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

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

This example runs Terraform tests (*.tftest.hcl) against a local AWS sandbox — no AWS account or

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

Demonstrates automatic retry configuration for workflow steps.