# atmos version track set

Update selected fields of an existing dependency entry in `atmos.yaml`, preserving comments and formatting. Only flags you pass are changed.

## Usage

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

## Arguments

- **`NAME` required**
  Entry name to update.

## Flags

- **`--desired`**
  Desired version: concrete, SemVer constraint, or 
  `latest`
  .
- **`--package`**
  Package coordinate.
- **`--provider`**
  Provider name from 
  `version.providers`
  .
- **`--group`**
  Version group name.
- **`--pin`**
  Pin policy: 
  `digest`
  , 
  `sha`
  , or 
  `none`
  .
- **`--include`**
  Candidate version patterns to include. Repeat the flag for multiple patterns.
- **`--exclude`**
  Candidate version patterns to exclude. Repeat the flag for multiple patterns.
- **`--prerelease`**
  Allow or disallow prerelease candidates for this entry.

## Examples

```shell
# Move checkout to the v6 desired range
atmos version track set checkout --desired=v6

# Render nginx with an immutable OCI digest
atmos version track set nginx --pin=digest

# Exclude a known vulnerable release and keep prereleases disabled
atmos version track set checkout --exclude=v6.0.0 --prerelease=false

# Move an entry into a group on prod
atmos version track set opentofu --track=prod --group=infrastructure
```