# atmos terraform cache list

List every cached provider and module object, with its cache key, group, kind, size, and age.

## Usage

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

## Flags

- **`--format` / `-f`** — Output format: `table` (default), `json`, or `yaml`.

## Examples

```shell
# List cached objects (table)
atmos terraform cache list

# Machine-readable output
atmos terraform cache list --format=json
```

## Try it out

### caching

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

```shell
atmos init examples/caching
cd caching
```

Install Terraform, then follow the README to initialize the sample component and inspect provider caching.

```shell
atmos terraform cache list
```

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

## Related Commands

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