# atmos terraform migrate list

Use `atmos terraform migrate list` to inspect which Terraform component instances have `kind: tfmigrate` hooks and which history settings Atmos will expose.

> ⚠️ Experimental

## Usage

```shell
atmos terraform migrate list [component] [options]
```

## Arguments

- **`component`** — Optional component name filter.

## Flags

- **`--stack` / `-s`** — Filter results to a stack.
- **`--identity` / `-i`** — Identity to authenticate before resolving stacks and component migration context. Environment variable: `ATMOS_IDENTITY`.
- **`--components`** — Filter results to one or more component names.
- **`--query`** — Filter component instances with a YQ expression.
- **`--format` / `-f`** — Output format. Supported values: `table`, `json`, `yaml`, `csv`, `tsv`.
- **`--columns`** — Columns to display. Use field names such as `component`, `stack`, `workspace`, `hook`, `mode`, `history_bucket`, and `history_key`.
- **`--sort`** — Sort by column and order, for example `stack:asc,component:asc`.
- **`--delimiter`** — Delimiter for CSV or TSV output.

## Examples

List migration context for a stack:

```shell
atmos terraform migrate list -s plat-ue2-dev
```

List with an explicit identity:

```shell
atmos terraform migrate list -s plat-ue2-dev --identity aws-prod
```

Show history keys for matching components:

```shell
atmos terraform migrate list --query '.settings.requires_migration == true' --columns component --columns stack --columns history_key
```

Output JSON for automation (no `[component]` argument lists every component in every stack):

```shell
atmos terraform migrate list --format json
```

## Output Columns

Default columns include component, stack, workspace, hook, mode, migration, config, history storage, history bucket, history key, and history role ARN.

Atmos scopes the `history_key` value by stack, component, and workspace:

```text
tfmigrate/<stack>/<component>/<workspace>/history.json
```

## Related

- [`atmos terraform migrate`](/cli/commands/terraform/migrate)
- [`atmos terraform migrate plan`](/cli/commands/terraform/migrate-plan)
- [`atmos terraform migrate apply`](/cli/commands/terraform/migrate-apply)