# atmos terraform cache prune

Remove cached registry metadata older than the retention window. Immutable artifacts (provider zips, module archives) are kept unless you opt in with `--all`.

## Usage

```shell
atmos terraform cache prune [flags]
```

## Flags

- **`--older-than`**
  Prune objects older than this Go duration (e.g. 
  `168h`
  , 
  `720h`
  ). Defaults to 
  `168h`
  .
- **`--all`**
  Also prune immutable artifacts (provider zips, module archives), not just metadata.
- **`--dry-run`**
  Show what would be pruned without deleting anything.

## Examples

```shell
# Prune metadata older than the default 168h window
atmos terraform cache prune

# Preview a more aggressive prune that also removes old artifacts
atmos terraform cache prune --older-than=720h --all --dry-run
```

## Related Commands

- [`atmos terraform cache stats`](/cli/commands/terraform/cache/stats)
- [`atmos terraform cache delete`](/cli/commands/terraform/cache/delete)