Skip to main content

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​

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​

# 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:

> 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.