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

Design Pattern[Read more](/design-patterns/version-management/source-based-versioning)

## Usage

```shell
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`](/cli/commands/list/sources).
:::

## Examples

### List All Helmfile Sources Across All Stacks

```shell
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

```shell
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

```shell
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

```shell
# 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:

| Context | Columns Shown |
|---------|---------------|
| All stacks | Stack, 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

- [Source-Based Version Pinning](/design-patterns/version-management/source-based-versioning) - Design pattern for per-environment version control
- [`atmos list sources`](/cli/commands/list/sources) - Unified view across all component types
- [`atmos helmfile source`](/cli/commands/helmfile/source) - Parent command overview
- [`atmos helmfile source describe`](/cli/commands/helmfile/source/describe) - View source configuration for a specific component
- [`atmos helmfile source pull`](/cli/commands/helmfile/source/pull) - Vendor a specific component