Unreleased Content

This page lists documentation that contains content not yet included in a formal release. The features or changes described may be available in the development version but are pending an official release.

What "Unreleased" Means

Pages marked as unreleased indicate that:

• Portions of the content, or possibly the entire page, may refer to functionality that has not yet been released
• The documentation was recently updated and those changes are not yet associated with a stable release
• Releases happen on a weekly cadence — you can expect these changes to be associated with a formal release soon

Once a release is published that includes the documented changes, the "Unreleased" badge will automatically be removed.

Currently Unreleased Documentation

The following documentation pages have changes that are not yet included in a release:

This list was generated on June 24, 2026.

• !secret

  Resolve a declared secret from its configured backend for an Atmos component in a stack

• !store

  Read a value from a store for an Atmos component in a stack

• !store.get

  Retrieve arbitrary keys directly from a store

• alert
• Ansible Components

  Configure Ansible components in your Atmos stack manifests for configuration management and automation.

• arguments
• atmos
• atmos ci cache

  Manage the CI build cache — restore and save the toolchain and other regenerable artifacts across CI jobs.

• atmos ci cache delete

  Delete a CI cache entry by key.

• atmos ci cache list

  List CI cache entries.

• atmos ci cache paths

  Print the cache key and paths for use with actions/cache.

• atmos ci cache restore

  Restore the CI cache into the well-known cache directory.

• atmos ci cache save

  Save the well-known cache directory to the CI cache.

• atmos container

  Build, run, and operate persistent, stack-scoped container components.

• atmos git

  GitOps enablement for Atmos — make automated Git commits easy, safe, and conventional both locally and in CI across every project.

• atmos git clean

  Remove managed Git repository workdirs safely.

• atmos git clone

  Clone or reconcile a managed Git repository, an ad hoc URI, or the current CI repository.

• atmos git commit

  Stage managed paths and create a commit in a managed Git repository.

• atmos git diff

  Show changes between the working tree and HEAD in a managed Git repository.

• atmos git hooks

  Manage local Git hooks that delegate to Atmos workflows and custom commands.

• atmos git hooks install

  Install local .git/hooks shims that delegate to atmos git hooks run.

• atmos git hooks run

  Run a local Git hook command configured under git.hooks.

• atmos git hooks uninstall

  Remove Atmos-generated local Git hook shims.

• atmos git init

  Initialize a managed Git repository from scratch, optionally seeded from another repository.

• atmos git list

  List Git repositories configured under git.repositories.

• atmos git pull

  Fast-forward pull a managed Git repository or a local path.

• atmos git push

  Push commits to a remote Git repository with bounded retry and no force push.

• atmos git status

  Show the working tree status of a managed Git repository or a local path.

• Atmos Pro

  The control plane for coordinating infrastructure at scale across teams, repos, and organizations

• atmos secret

  Declare, provision, and resolve secrets backed by cloud secret stores or SOPS-encrypted files.

• atmos secret delete

  Remove a declared secret's value from its backend, with a confirmation prompt.

• atmos secret exec

  Run a command with a component's declared secrets injected as environment variables.

• atmos secret get

  Retrieve a declared secret's value, optionally extracting a nested field with a YQ path.

• atmos secret import

  Bring existing secret values under management — from a file, or from an existing store coordinate.

• atmos secret init

  Provision declared secrets for a stack and component, prompting for any that are missing.

• atmos secret keygen

  Generate an age key for a SOPS-backed secrets vault, in-process, with no manual age-keygen.

• atmos secret list

  List declared secrets for a stack and component along with their initialization status.

• atmos secret pull

  Download initialized declared secrets to a local .env or JSON file for development.

• atmos secret push

  Upload secret values from a local file, failing if any key is not declared.

• atmos secret set

  Set a declared secret's value from an argument, standard input, or an interactive prompt.

• atmos secret shell

  Launch an interactive shell with a component's declared secrets in the environment.

• atmos secret validate

  Validate that every required declared secret is initialized in its backend.

• atmos terraform
• atmos terraform apply
• atmos terraform cache

  Transparently cache Terraform/OpenTofu providers and modules, and manage the cache.

• atmos terraform cache delete

  Delete a specific cached object by its cache key.

• atmos terraform cache list

  List cached Terraform providers and modules.

• atmos terraform cache mirror

  Pre-seed the registry cache with providers for multiple platforms.

• atmos terraform cache prune

  Remove stale cached registry metadata.

• atmos terraform cache stats

  Show cache size, object count, and provider/module breakdown.

• atmos terraform cache trust

  Trust the registry cache proxy certificate in the OS trust store (required once on macOS and Windows).

• atmos terraform cache untrust

  Remove the registry cache proxy certificate from the OS trust store.

• atmos terraform deploy
• atmos terraform generate varfile
• atmos terraform generate varfiles

  Use this command to generate the Terraform varfiles (`.tfvar`) for all Atmos terraform components in all stacks.

• atmos terraform shell

  This command starts a new `SHELL` configured with the environment for an Atmos component in a stack to allow execution of all native terraform commands inside the shell without using any atmos-specific arguments and flags. This may by helpful to debug a component without going through Atmos.

• atmos toolchain info

  Display detailed registry information about a toolchain tool.

• atmos workflow

  Use this command to perform sequential execution of `atmos` and `shell` commands defined as workflow steps.

• atmos.Store

  Read a value from a store

• Azure Authentication

  Complete guide for authenticating to Azure using Atmos Auth with device code flow, OIDC, and service principals.

• choose
• CI Cache Configuration

  Configure the CI build cache that restores and saves the toolchain and other regenerable artifacts across CI jobs.

• clear
• command
• commands
• component
• Component Library

  Introduction to Atmos components - the building blocks of your infrastructure

• Component Retry

  Automatically retry transient Terraform errors with configurable backoff and pattern matching.

• Configure Component Metadata

  Use the metadata section to control component behavior, inheritance, and deployment settings.

• Configure Environment Variables

  Use the env section to set environment variables for your Terraform, Helmfile, Packer, or Ansible components.

• confirm
• container
• container
• container
• Custom Commands

  Use the `atmos.yaml` to configure any number of custom commands you want to add to the Atmos CLI.

• dependencies
• dependencies
• Deploy Another App

  Provision multiple components in the same stack

• env
• env
• env
• env
• Environment Variables

  Configure global environment variables for all Atmos operations

• Environment Variables

  Complete reference for all Atmos environment variables.

• exec
• exit
• file
• filter
• flags
• format
• Git Configuration

  Configure managed Git repositories, authentication, local Git hooks, and list output in atmos.yaml.

• Global Flags

  Complete reference for all global command-line flags available in Atmos

• Helmfile Components

  Configure Helmfile components in your Atmos stack manifests for Kubernetes deployments.

• identity
• identity
• input
• interactive
• join
• linebreak
• log
• Manage Lifecycle Events with Hooks

  Run scanners, cost estimators, custom commands, and store outputs at component lifecycle events.

• markdown
• Multi-Cloud

  Atmos was designed from the ground up to be cloud agnostic. Multi-cloud integrations are community supported.

• Native CI

  Native CI/CD integration for GitHub Actions and other CI providers

• output
• output
• outputs
• Packer Components

  Configure Packer components in your Atmos stack manifests for machine image building.

• pager
• Planfile Storage

  Store and verify Terraform planfiles across CI pipeline stages

• Profiles

  Configure named profiles for environment-specific Atmos settings

• retry
• Secrets Configuration

  Configure secret backends and declare secrets for use with !secret and the atmos secret CLI.

• shell
• show
• show
• sleep
• spin
• stack
• stage
• step
• steps
• steps
• Stores Configuration

  Configure external stores for sharing data between components in atmos.yaml.

• style
• table
• Terraform Configuration

  Configure Terraform and OpenTofu component behavior in atmos.yaml.

• Terraform Planfiles
• title
• toast
• tty
• type
• Use Your Component in a Stack
• Using Containers

  Run persistent, stack-scoped container services with the same stack-based configuration used for Terraform and Helmfile. One component is one container, operated by labels.

• Using Custom Component Types

  Bring any tool—AWS CDK, CloudFormation, Pulumi, Bicep, database migrations, and more—under the same stack-based configuration used for Terraform, Helmfile, and Packer.

• Using External Stores

  Share data through external stores like SSM Parameter Store, AWS Secrets Manager, Artifactory, and more

• workflow
• workflows
• working_directory
• working_directory
• working_directory
• write

Stay Updated

To know when unreleased features become available:

• Watch the Changelog — All releases are documented with their changes
• Follow GitHub Releases — Get notified of new releases
• Join our Slack Community — Discuss upcoming features with the team

Related

• Changelog — View recent releases and changes
• Experimental Features — Features under active development
• Roadmap — View our product roadmap