# atmos version track status

Check whether tracked dependencies are locked, current, or eligible for updates. See when a newer
release is held back by your update policy so you can distinguish available releases from permitted
upgrades.

## Status Values

- **`current`** — The locked version matches the policy-eligible target.
- **`update-available`** — A policy-eligible update differs from the locked version. `update` would take it.
- **`newer-available (blocked)`** — A newer version exists upstream, but policy holds it back. The entry still passes `verify`.
- **`unlocked`** — The entry has no lock file record.
- **`locked`** — The entry is locked, but its target could not be resolved.

## Usage

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

## Flags

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

## Examples

```shell
# Show status for prod
atmos version track status prod

# Show infrastructure group status as JSON
atmos version track status prod --group=infrastructure --format=json
```

## 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 status prod --format=csv
Track,Name,Group,Desired,Locked,Resolved,Status,Message
prod,checkout,infrastructure,v6,v6.1.0,v6.2.0,update-available,
prod,nginx,infrastructure,1.x,1.29.0,1.30.0,newer-available (blocked),"1.30.0 released 3d ago; cooldown 14d has not elapsed"
```

Use `--format=yaml` or `--format=json` for the full-fidelity result, including fields the table
omits (e.g. ecosystem, datasource, package).

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

Inspect the desired and locked versions across the example catalog. No cloud credentials are needed.

```shell
atmos version track status
```

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