# atmos version track list

Compare dependency versions across your project's version tracks in one table. See where
environments use different versions and identify dependencies that have not been locked yet.

## Usage

```shell
atmos version track list [flags]
```

## Flags

- **`--show string`** — Version value to show per track: `desired` (the configured version, no lock file read) or `locked` (the resolved version from `versions.lock.yaml`, blank if not yet locked) (default: `locked`)
- **`--format string`** — Output format: `table`, `json`, `yaml`, `csv`, `tsv` (default: `table`)
- **`--max-columns int`** — Limit the number of track columns displayed (default: `0`, no limit)

## Examples

```shell
# Show the locked version for every dependency, across all tracks
atmos version track list

# Show the configured (desired) version instead of the locked version
atmos version track list --show=desired

# Print the matrix as JSON: track -> dependency -> version
atmos version track list --format=json

# Print as CSV for spreadsheet import
atmos version track list --format=csv
```

## Example Output

In an interactive terminal, `--format=table` (the default) renders a styled table with
`Dependency` as the first column and one column per track. Non-interactive output (e.g.
piped, or `--format=csv`) looks like:

```shell
> atmos version track list --format=csv
Key,dev,prod,staging
checkout,v6.1.0,v6.2.0,v6.1.0
nginx,1.28.0,1.29.0,1.28.0
opentofu,1.10.5,1.10.6,1.10.5
```

A blank cell means that dependency isn't locked yet for that track (`--show=locked`, the
default) — run `atmos version track lock <track>` to resolve it.

## Try it out

### version-tracker

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

```shell
atmos init examples/version-tracker
cd version-tracker
```

Compare the checked-in dev and prod tracks. No cloud credentials are needed.

```shell
atmos version track list
```

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