Skip to main content

atmos version track list

List the configured version tracks from atmos.yaml as a comparison table: each row is a dependency and each column is a track, so you can compare versions across all tracks at a glance.

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.