atmos version track

Use atmos version track (alias: tracks) to manage software versions declared under version: in atmos.yaml, resolved into versions.lock.yaml, and applied to project files by the file managers.

The top-level atmos version command reports and manages the Atmos CLI itself. atmos version track manages software versions whether Atmos installs and runs the software locally through Toolchain, or only tracks, locks, and renders the version into files such as GitHub Actions workflows, container image references, templates, and configuration.

Usage

atmos version track <subcommand> [track] [flags]

Most subcommands accept an optional [track] argument. The target track resolves in this order: positional argument, --track flag, version.track in atmos.yaml, then default.

Subcommands

Subcommand	Description
list	List configured version tracks as a dependency x track version matrix.
show	Show a track's effective entries after defaults and group policies are applied.
get	Show one dependency entry with its effective policy and lock state.
add	Add a dependency entry to atmos.yaml.
set	Update fields of an existing dependency entry.
remove	Remove a dependency entry.
lock	Resolve desired versions as-is and write the lock file.
update	Advance locked versions within policy.
status	Show policy-aware lock and update status.
diff	Show entries that are unlocked or have policy-eligible updates.
apply	Rewrite version-managed files from the lock.
verify	CI gate for lock freshness and managed-file currency.

Global Flags

--format

Output format: yaml (default) or json.

--track

Version track to operate on. A positional [track] argument takes precedence.

Example

atmos version track status prod --format=json
atmos version track apply prod --check
atmos version track verify prod

See Also

• Managed Versions Configuration
• Version Track Configuration
• !version