# atmos terraform planfile list

List Terraform plan files from the configured storage backend. Optionally filter by component (positional arg) and/or stack (`-s` flag). By default, only planfiles for the current SHA are shown. Use `--all` to show all SHAs.

> ⚠️ Experimental

## Usage

```shell
atmos terraform planfile list [component] [flags]
```

## Arguments

- **`[component]`** — Optional component name to filter planfiles.

## Flags

- **`--all`** — Show planfiles for all SHAs (bypass SHA filter).
- **`--format`** — Output format: `table` (default), `json`, `yaml`, `csv`, `tsv`.
- **`--store`** — Storage backend to use (default from config).

## Examples

```shell
# List planfiles for the current SHA
atmos terraform planfile list

# List all planfiles (all SHAs)
atmos terraform planfile list --all

# List planfiles for a specific component
atmos terraform planfile list vpc -s dev-us-east-1

# JSON output for scripting
atmos terraform planfile list --format json

# List from a specific store
atmos terraform planfile list --store s3
```

## Related

- [`atmos terraform planfile upload`](/cli/commands/terraform/planfile/upload) - Upload planfiles
- [`atmos terraform planfile download`](/cli/commands/terraform/planfile/download) - Download planfiles
- [`atmos terraform planfile show`](/cli/commands/terraform/planfile/show) - Show planfile details