# axx upgrade

> Upgrade Axx to its newest release, say what changed, and update the skills

Source: https://axx.nimbusxr.us/next/references/cli/axx-upgrade/

Upgrade Axx to its newest release, or to the version --version names, older ones
too. It says what changed between the versions, breaking changes first, and then
updates the agent skills of this project and your home directory, where they are
installed.

In a project whose axx.yaml names its version (`axx: 0.5.0`), it moves that line,
checks the project on the new version with `axx validate` and `axx lint`, and leaves
the line for you to commit. An installed Axx older than the newest release comes
along; --version moves only the project. Outside a project, it upgrades only the
installed Axx.

An Axx from the install scripts or a release archive replaces itself, after
checking the download against the release's checksums. Homebrew's is upgraded with
`brew`, and `go install`'s with `go install`. A project's version comes from GitHub
however Axx was installed, as its Homebrew tap keeps only the newest. GITHUB_TOKEN, if it is
set, avoids GitHub's rate limit.

```text
Usage:
  axx upgrade [flags]

Flags:
      --check[=true|false]   say what a newer release would change, without installing it
  -h, --help[=true|false]    help for upgrade
      --version string       the version to go to, like 0.4.0 or nightly, instead of the newest

Global Flags:
      --compact[=true|false]    print only what matters (auto-enabled for coding agents)
  -c, --config string           path to axx.yaml (default: search upward from the working directory)
      --json[=true|false]       emit machine-readable JSON (stable envelope)
      --no-color[=true|false]   disable colored output
  -v, --verbose count           increase log verbosity (-v, -vv)
```