# atmos version track diff

Preview the dependency entries that need lock changes before updating a version track. See unlocked
entries and available updates that your policy permits, so you can review the scope of an update.

## Usage

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

## Flags

- **`--group`** — Limit the diff to entries in the named version group.
- **`--format string`** — Output format: `table`, `json`, `yaml`, `csv`, `tsv` (default: `table`)

## Examples

```shell
# Show all entries that need lock changes in prod
atmos version track diff prod

# Show only infrastructure group changes
atmos version track diff prod --group=infrastructure
```

## Example Output

In an interactive terminal, `--format=table` (the default) renders a styled table.
Use `--format=csv` or `--format=tsv` for delimited output; piped table output remains a table.

```shell
> atmos version track diff prod --format=csv
Track,Name,Group,Desired,Locked,Resolved,Status,Message
prod,checkout,infrastructure,v6,v6.1.0,v6.2.0,update-available,
```

Use `--format=yaml` or `--format=json` for the full-fidelity result.

## 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 dev track against its locked versions. No cloud credentials are needed.

```shell
atmos version track diff dev
```

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