# atmos terraform planfile download

Download a Terraform plan file from the configured storage backend. The component is specified as a positional argument and the stack via `-s`/`--stack`. Use `--output` to specify the output path (defaults to `plan.tfplan` in the current directory).

> ⚠️ Experimental

## Usage

```shell
atmos terraform planfile download <component> [flags]
```

## Arguments

- **`<component>`**
  Component name to download the planfile for (required).

## Flags

- **`-o`, `--output`**
  Output path for the downloaded planfile. Default: 
  `plan.tfplan`
  .
- **`--store`**
  Storage backend to use (default from config).

## Examples

```shell
# Download planfile with default output path
atmos terraform planfile download vpc -s dev-us-east-1

# Download to a specific path
atmos terraform planfile download vpc -s dev-us-east-1 --output ./plans/vpc.planfile

# Download from a specific store
atmos terraform planfile download vpc -s dev-us-east-1 --store s3
```

## Related

- [`atmos terraform planfile upload`](/cli/commands/terraform/planfile/upload) - Upload planfiles
- [`atmos terraform planfile list`](/cli/commands/terraform/planfile/list) - List stored planfiles