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

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

## Usage

```shell
atmos list sources [component] [flags]
```

List all components with source configuration across all stacks:

```shell
atmos list sources
```

Filter to a specific stack:

```shell
atmos list sources --stack dev
```

Filter to a specific component across all stacks:

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

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

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

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

```shell
# 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`
- **`--tags`** — Filter by component tags (comma-separated, matches any): `--tags=production,tier-1`. Components are tagged via an optional `metadata.tags: [...]` list in stack manifests.Environment variable: `ATMOS_COMPONENT_TAGS`
- **`--labels`** — Filter by component labels (comma-separated `key=value` or `key:value` pairs in one flag value, matches all): `--labels=cost-center=platform,compliance:sox`. Components are labeled via an optional `metadata.labels: {...}` map in stack manifests.Environment variable: `ATMOS_COMPONENT_LABELS`
- **`--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:

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

## Related Commands

For type-specific source listing:

- [`atmos terraform source list`](/cli/commands/terraform/source/list) - List only Terraform components with source
- [`atmos helmfile source list`](/cli/commands/helmfile/source/list) - List only Helmfile components with source
- [`atmos packer source list`](/cli/commands/packer/source/list) - List only Packer components with source

For source management:

- [`atmos terraform source pull`](/cli/commands/terraform/source/pull) - Vendor a Terraform component
- [`atmos terraform source describe`](/cli/commands/terraform/source/describe) - View source configuration details

## Try it out

### source-provisioning

Copy the example into a new directory and make it your own:

```shell
atmos init examples/source-provisioning
cd source-provisioning
```

List the configured component source locations before provisioning them.

```shell
atmos list sources
```

- [Installation guide](/install)
- [Explore the example](/examples/source-provisioning)
- [Initialization and repository settings](/cli/commands/init#examples-and-source-directories)

## See Also

- [Source-Based Version Pinning](/design-patterns/version-management/source-based-versioning) - Design pattern for per-environment version control
- [`atmos list components`](/cli/commands/list/components) - List all components