# atmos version track apply

Update version references in your project files to match the lock file. Use this command to keep
workflows, configuration, and generated files aligned with the dependency versions you have
selected.

The file managers rewrite paths configured in `version.files` using values from the lock file. The alias is `sync`.

## Usage

```shell
atmos version track apply [track] [flags]
atmos version track sync [track] [flags]
```

## File Managers

- **`github-actions`**
  Scans workflow files for 
  `uses:`
   lines and rewrites refs from the lock by 
  `owner/repo`
   package.
- **`marker`**
  Rewrites version tokens on lines annotated with 
  `<comment> atmos:version <name> [match=<regex>]`
  .
- **`json`**
  Writes locked values into JSON files at configured field paths, preserving formatting and key order.
- **`yaml`**
  Writes locked values into YAML files at configured field paths, preserving comments, anchors, and key order.
- **`template`**
  Renders 
  `*.tmpl`
   files to sibling files with the 
  `.tmpl`
   suffix stripped, using the 
  `.version`
   context.

See [Version Files Configuration](/cli/configuration/version/files) for `version.files` and marker syntax.

## Flags

- **`--check`**
  Fail without writing when managed files are out of date. Intended for CI.
- **`--dir`**
  Root directory to resolve managed paths from. Defaults to the current directory.
- **`--manager`**
  Limit the run to the named file managers. Repeat the flag for multiple managers.

## Examples

```shell
# Rewrite every configured managed file from the lock
atmos version track apply prod

# CI: fail if any managed file is stale
atmos version track apply prod --check

# Only rewrite GitHub Actions workflow refs
atmos version track apply prod --manager=github-actions
```