Skip to main content

atmos helmfile source list

Use this command to list all Helmfile components that have source configured. This shows 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 helmfile source list --help

Usage​

atmos helmfile source list [component] [flags]

Description​

The list command scans component configurations and displays all Helmfile components that have source defined. This helps identify:

  • Which components are configured for JIT vendoring
  • The source URIs and versions for each component
  • Components that may need to be vendored before use
tip

To list sources across all component types (Terraform, Helmfile, Packer) in a unified view, use atmos list sources.

Examples​

List All Helmfile Sources Across All Stacks​

atmos helmfile source list

Output:

STACK              COMPONENT       URI                                                         VERSION
plat-ue2-dev       ingress-nginx   github.com/cloudposse/helmfiles//releases/ingress-nginx     1.0.0
plat-ue2-dev       cert-manager    github.com/cloudposse/helmfiles//releases/cert-manager      1.0.0
plat-ue2-prod      ingress-nginx   github.com/cloudposse/helmfiles//releases/ingress-nginx     1.1.0

List Sources in a Specific Stack​

atmos helmfile source list --stack plat-ue2-dev

When filtering by stack, the Stack column is omitted:

COMPONENT       URI                                                         VERSION
ingress-nginx   github.com/cloudposse/helmfiles//releases/ingress-nginx     1.0.0
cert-manager    github.com/cloudposse/helmfiles//releases/cert-manager      1.0.0

List Sources for a Specific Component​

atmos helmfile source list ingress-nginx

Shows the component across all stacks:

STACK              COMPONENT       URI                                                         VERSION
plat-ue2-dev       ingress-nginx   github.com/cloudposse/helmfiles//releases/ingress-nginx     1.0.0
plat-ue2-prod      ingress-nginx   github.com/cloudposse/helmfiles//releases/ingress-nginx     1.1.0

Output in Different Formats​

# JSON format
atmos helmfile source list --format json

# YAML format
atmos helmfile source list --format yaml

# CSV format
atmos helmfile source list --format csv

# TSV format (tab-separated, for pipelines)
atmos helmfile source list --format tsv

Dynamic Columns​

The command automatically adjusts columns based on context:

ContextColumns Shown
All stacksStack, Component, Folder*, URI, Version
Single stack (--stack)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.

Arguments​

component (optional)
Filter results to a specific component name or folder (metadata.component). When provided, only shows sources for components matching this name 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

See Also​