# atmos version track apply

Run the file managers over paths configured in `version.files` and rewrite version references 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>]`
  .
- **`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
```