# atmos terraform planfile

The `atmos terraform planfile` command group provides tools for managing Terraform planfiles. Store, retrieve, and share planfiles across CI/CD pipelines using local filesystem, S3, or GitHub Artifacts storage.

> ⚠️ Experimental

**Configure CI Integration**

Learn how to configure CI/CD integration in your `atmos.yaml`, including setting up providers (like GitHub Actions), managing workflows, environment variables, and secrets for automated infrastructure pipelines.

CI Configuration Reference[Read more](/cli/configuration/ci)

## Subcommands

## Storage Backends

Atmos supports multiple storage backends for planfiles:

- **`local/dir`**

  Store planfiles on the local filesystem. Useful for development and single-machine workflows.

  Default path: `.atmos/planfiles/`
- **`aws/s3`**

  Store planfiles in Amazon S3. Ideal for team workflows and cross-region access.

  Configure via `ATMOS_PLANFILE_BUCKET` and `ATMOS_PLANFILE_PREFIX` environment variables.
- **`github/artifacts`**

  Store planfiles as GitHub Actions artifacts. Perfect for GitHub-native CI/CD workflows.

  Automatically detected when running in GitHub Actions.

## Related

- [CI Configuration](/cli/configuration/ci) - Configure CI integration in `atmos.yaml`
- [`atmos terraform plan`](/cli/commands/terraform/plan) - Generate plans that can be uploaded
- [Native CI](/ci) - CI/CD integration overview