Skip to main content

atmos list sources

Use this command to list all components with source configuration across all component types (Terraform, Helmfile, Packer) in a unified view. This provides a single table showing which components can be vendored using the source provisioner.

Source-Based Version Pinning

Learn how to configure the source field for per-environment version control.

atmos list sources --help

Usage​

atmos list sources [component] [flags]

List all components with source configuration across all stacks:

atmos list sources

Filter to a specific stack:

atmos list sources --stack dev

Filter to a specific component across all stacks:

atmos list sources vpc
tip

Run atmos list sources --help to see all available options.

Description​

The list sources command provides a unified view of all components that have source configured, regardless of component type. Unlike the type-specific commands (atmos terraform source list, atmos helmfile source list, atmos packer source list), this command shows all types together with a "Type" column.

This helps identify:

  • All components configured for JIT vendoring across your entire infrastructure
  • The source URIs and versions for each component
  • Which component types (terraform, helmfile, packer) have source configurations
  • Components that may need to be vendored before use

Examples​

List All Sources Across All Stacks​

atmos list sources

Example output:

STACK              TYPE        COMPONENT    URI                                                           VERSION
plat-ue2-dev       terraform   eks          github.com/cloudposse/terraform-aws-components//modules/eks   1.450.0
plat-ue2-dev       terraform   vpc          github.com/cloudposse/terraform-aws-components//modules/vpc   1.450.0
plat-ue2-dev       helmfile    nginx        github.com/cloudposse/helmfile-components//charts/nginx               1.0.0
plat-ue2-prod      terraform   eks          github.com/cloudposse/terraform-aws-components//modules/eks   1.451.0
plat-ue2-prod      terraform   vpc          github.com/cloudposse/terraform-aws-components//modules/vpc   1.451.0

List Sources in a Specific Stack​

atmos list sources --stack plat-ue2-dev

When filtering by stack, the Stack column is omitted:

TYPE        COMPONENT    URI                                                           VERSION
terraform   eks          github.com/cloudposse/terraform-aws-components//modules/eks   1.450.0
terraform   vpc          github.com/cloudposse/terraform-aws-components//modules/vpc   1.450.0
helmfile    nginx        github.com/cloudposse/helmfile-components//charts/nginx               1.0.0

List Sources for a Specific Component​

atmos list sources vpc

Shows the component across all stacks where it has source configured:

STACK              TYPE        COMPONENT    URI                                                           VERSION
plat-ue2-dev       terraform   vpc          github.com/cloudposse/terraform-aws-components//modules/vpc   1.450.0
plat-ue2-prod      terraform   vpc          github.com/cloudposse/terraform-aws-components//modules/vpc   1.451.0
plat-ue2-staging   terraform   vpc          github.com/cloudposse/terraform-aws-components//modules/vpc   1.450.0

Output in Different Formats​

# JSON format
atmos list sources --format json

# YAML format
atmos list sources --format yaml

# CSV format
atmos list sources --format csv

Arguments​

component (optional)
Filter results to a specific component name or folder (metadata.component). When provided, only shows matching sources across all stacks.

Flags​

--stack / -s (optional)
Filter by stack name. When provided, only shows sources within that stack and omits the Stack column from output.
Environment variable: ATMOS_STACK
--format / -f
Output format: table, json, yaml, csv, tsv (default: table).
Environment variable: ATMOS_FORMAT
--process-templates
Enable/disable Go template processing in Atmos stack manifests (default true). Go template functions include atmos.Component(...).
Environment variable: ATMOS_PROCESS_TEMPLATES
--process-functions
Enable/disable YAML functions processing in Atmos stack manifests (default true). YAML functions include !terraform.state, !terraform.output, !store, !aws.*, etc. This is distinct from Go template functions like atmos.Component(...), which are controlled by --process-templates.
Environment variable: ATMOS_PROCESS_FUNCTIONS
--skip
Skip executing a specific YAML function in the Atmos stack manifests when processing stacks. Repeat the flag to skip multiple functions (for example, --skip terraform.state --skip terraform.output). Use this to bypass a single function (such as a backend-resolving !terraform.state call) while leaving other YAML functions enabled.
Environment variable: ATMOS_SKIP

Dynamic Columns​

The command automatically adjusts columns based on context:

ContextColumns Shown
All stacksStack, Type, Component, Folder*, URI, Version
Single stack (--stack)Type, Component, Folder*, URI, Version

*The Folder column only appears when any component uses metadata.component to specify a different folder name than the component instance name.

For type-specific source listing:

For source management:

See Also​