# atmos version track get

Read a dependency's locked version or another effective setting after defaults and group policies
are applied. Use the result in scripts or to check how a particular dependency is configured.

By default, this command prints the entry's locked version. Use `--show` to select a different field.

## Usage

```shell
atmos version track get NAME [flags]
```

## Arguments

- **`NAME` required** — Entry name to show.

## Flags

- **`--show` string** — Entry field to display: `name`, `ecosystem`, `datasource`, `provider`, `package`, `desired`, `group`, `update`, `include`, `exclude`, `prerelease`, `labels`, `locked`. Defaults to `locked`.
- **`--track` string** — Version track to operate on. Defaults to `version.track` in `atmos.yaml`.
- **`--format` string** — Output format: `yaml`, `json`. Defaults to `yaml`.

## Examples

```shell
# Get the locked version of an entry from the default track
atmos version track get checkout

# Get the desired (unlocked) version instead
atmos version track get checkout --show=desired

# Get a different field, from a specific track, as JSON
atmos version track get checkout --track=prod --show=ecosystem --format=json
```

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

Read the locked redis version from the dev track. No cloud credentials are needed.

```shell
atmos version track get redis --track dev
```

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