diff --git a/CHANGELOG.md b/CHANGELOG.md
index 876dc6b14d..747e3b50ee 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,18 @@
 # Changelog
 
+## [2025.9.22](https://github.com/jdx/mise/compare/v2025.9.21..v2025.9.22) - 2025-09-28
+
+### 📦 Registry
+
+- re-enable tests by @risu729 in [#6454](https://github.com/jdx/mise/pull/6454)
+- restore comments and tests by @risu729 in [#6378](https://github.com/jdx/mise/pull/6378)
+- add github backend for graphite by @jdx in [#6455](https://github.com/jdx/mise/pull/6455)
+
+### 🚀 Features
+
+- **(backend)** add environment variable override for tool backends by @jdx in [#6456](https://github.com/jdx/mise/pull/6456)
+- add a http_retries setting to define number of retry attempts by @roele in [#6444](https://github.com/jdx/mise/pull/6444)
+
 ## [2025.9.21](https://github.com/jdx/mise/compare/v2025.9.20..v2025.9.21) - 2025-09-27
 
 ### 📦 Registry
diff --git a/Cargo.lock b/Cargo.lock
index 20d54118fd..48d172f1c3 100644
--- a/Cargo.lock
+++ b/Cargo.lock
@@ -4532,7 +4532,7 @@ dependencies = [
 
 [[package]]
 name = "mise"
-version = "2025.9.21"
+version = "2025.9.22"
 dependencies = [
  "aqua-registry",
  "async-backtrace",
diff --git a/Cargo.toml b/Cargo.toml
index 65b7187e78..b8d59b845f 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -3,7 +3,7 @@ members = ["crates/vfox", "crates/aqua-registry"]
 
 [package]
 name = "mise"
-version = "2025.9.21"
+version = "2025.9.22"
 edition = "2024"
 description = "The front-end to your dev env"
 authors = ["Jeff Dickey (@jdx)"]
diff --git a/README.md b/README.md
index 18f18b340b..5c3e54722c 100644
--- a/README.md
+++ b/README.md
@@ -55,7 +55,7 @@ See [Getting started](https://mise.jdx.dev/getting-started.html) for more option
 ```sh-session
 $ curl https://mise.run | sh
 $ ~/.local/bin/mise --version
-2025.9.21 macos-arm64 (a1b2d3e 2025-09-27)
+2025.9.22 macos-arm64 (a1b2d3e 2025-09-28)
 ```
 
 Hook mise into your shell (pick the right one for your shell):
diff --git a/completions/_mise b/completions/_mise
index f9c81acfcc..ff9cc63eec 100644
--- a/completions/_mise
+++ b/completions/_mise
@@ -1,3 +1,5 @@
+# @generated by usage-cli from usage spec
+
 #compdef mise
 local curcontext="$curcontext"
 
@@ -15,7 +17,7 @@ _mise() {
   typeset -A opt_args
   local curcontext="$curcontext" spec cache_policy
 
-  if ! command -v usage &> /dev/null; then
+  if ! type -p usage &> /dev/null; then
       echo >&2
       echo "Error: usage CLI not found. This is required for completions to work in mise." >&2
       echo "See https://usage.jdx.dev for more information." >&2
@@ -27,14 +29,18 @@ _mise() {
     zstyle ":completion:${curcontext}:" cache-policy _usage_mise_cache_policy
   fi
 
-  if ( [[ -z "${_usage_spec_mise_2025_9_21:-}" ]] || _cache_invalid _usage_spec_mise_2025_9_21 ) \
-      && ! _retrieve_cache _usage_spec_mise_2025_9_21;
+  if ( [[ -z "${_usage_spec_mise_2025_9_22:-}" ]] || _cache_invalid _usage_spec_mise_2025_9_22 ) \
+      && ! _retrieve_cache _usage_spec_mise_2025_9_22;
   then
     spec="$(mise usage)"
-    _store_cache _usage_spec_mise_2025_9_21 spec
+    _store_cache _usage_spec_mise_2025_9_22 spec
   fi
 
-  _arguments "*: :(($(usage complete-word --shell zsh -s "$spec" -- "${words[@]}" )))"
+  local spec_file="${TMPDIR:-/tmp}/usage__usage_spec_mise_2025_9_22.spec"
+  if [[ ! -f "$spec_file" ]]; then
+    echo "$spec" > "$spec_file"
+  fi
+  _arguments "*: :(($(command usage complete-word --shell zsh -f "$spec_file" -- "${words[@]}" )))"
   return 0
 }
 
diff --git a/completions/mise.bash b/completions/mise.bash
index 637a62773a..9507a65da6 100644
--- a/completions/mise.bash
+++ b/completions/mise.bash
@@ -1,19 +1,24 @@
+# @generated by usage-cli from usage spec
 _mise() {
-    if ! command -v usage &> /dev/null; then
+    if ! type -p usage &> /dev/null; then
         echo >&2
         echo "Error: usage CLI not found. This is required for completions to work in mise." >&2
         echo "See https://usage.jdx.dev for more information." >&2
         return 1
     fi
 
-    if [[ -z ${_usage_spec_mise_2025_9_21:-} ]]; then
-        _usage_spec_mise_2025_9_21="$(mise usage)"
+    if [[ -z ${_usage_spec_mise_2025_9_22:-} ]]; then
+        _usage_spec_mise_2025_9_22="$(mise usage)"
     fi
 
 	local cur prev words cword was_split comp_args
     _comp_initialize -n : -- "$@" || return
+    local spec_file="${TMPDIR:-/tmp}/usage__usage_spec_mise_2025_9_22.spec"
+    if [[ ! -f "$spec_file" ]]; then
+        echo "${_usage_spec_mise_2025_9_22}" > "$spec_file"
+    fi
     # shellcheck disable=SC2207
-	_comp_compgen -- -W "$(usage complete-word --shell bash -s "${_usage_spec_mise_2025_9_21}" --cword="$cword" -- "${words[@]}")"
+	_comp_compgen -- -W "$(command usage complete-word --shell bash -f "$spec_file" --cword="$cword" -- "${words[@]}")"
 	_comp_ltrim_colon_completions "$cur"
     # shellcheck disable=SC2181
     if [[ $? -ne 0 ]]; then
diff --git a/completions/mise.fish b/completions/mise.fish
index 1514352c0a..4957c92243 100644
--- a/completions/mise.fish
+++ b/completions/mise.fish
@@ -1,17 +1,25 @@
+# @generated by usage-cli from usage spec
+
 # if "usage" is not installed show an error
-if ! command -v usage &> /dev/null
+if ! type -p usage &> /dev/null
     echo >&2
     echo "Error: usage CLI not found. This is required for completions to work in mise." >&2
     echo "See https://usage.jdx.dev for more information." >&2
     return 1
 end
 
-if ! set -q _usage_spec_mise_2025_9_21
-  set -g _usage_spec_mise_2025_9_21 (mise usage | string collect)
+if ! set -q _usage_spec_mise_2025_9_22
+  set -g _usage_spec_mise_2025_9_22 (mise usage | string collect)
+end
+set -l tmpdir (if set -q TMPDIR; echo $TMPDIR; else; echo /tmp; end)
+set -l spec_file "$tmpdir/usage__usage_spec_mise_2025_9_22.spec"
+if not test -f "$spec_file"
+    echo $_usage_spec_mise_2025_9_22 > "$spec_file"
 end
+
 set -l tokens
 if commandline -x >/dev/null 2>&1
-    complete -xc mise -a '(usage complete-word --shell fish -s "$_usage_spec_mise_2025_9_21" -- (commandline -xpc) (commandline -t))'
+    complete -xc mise -a "(command usage complete-word --shell fish -f \"$spec_file\" -- (commandline -xpc) (commandline -t))"
 else
-    complete -xc mise -a '(usage complete-word --shell fish -s "$_usage_spec_mise_2025_9_21" -- (commandline -opc) (commandline -t))'
+    complete -xc mise -a "(command usage complete-word --shell fish -f \"$spec_file\" -- (commandline -opc) (commandline -t))"
 end
diff --git a/crates/aqua-registry/aqua-registry/pkgs/CycloneDX/cyclonedx-cli/registry.yaml b/crates/aqua-registry/aqua-registry/pkgs/CycloneDX/cyclonedx-cli/registry.yaml
index 0bbe8285a7..0e95e4e276 100644
--- a/crates/aqua-registry/aqua-registry/pkgs/CycloneDX/cyclonedx-cli/registry.yaml
+++ b/crates/aqua-registry/aqua-registry/pkgs/CycloneDX/cyclonedx-cli/registry.yaml
@@ -16,10 +16,6 @@ packages:
           amd64: x64
           darwin: osx
           windows: win
-        overrides:
-          - goos: linux
-            goarch: amd64
-            asset: cyclonedx-{{.OS}}-musl-{{.Arch}}
       - version_constraint: "true"
         asset: cyclonedx-{{.OS}}-{{.Arch}}
         format: raw
@@ -27,7 +23,3 @@ packages:
           amd64: x64
           darwin: osx
           windows: win
-        overrides:
-          - goos: linux
-            goarch: amd64
-            asset: cyclonedx-{{.OS}}-musl-{{.Arch}}
diff --git a/default.nix b/default.nix
index 87b679cf7c..8df400bc1e 100644
--- a/default.nix
+++ b/default.nix
@@ -2,7 +2,7 @@
 
 rustPlatform.buildRustPackage {
   pname = "mise";
-  version = "2025.9.21";
+  version = "2025.9.22";
 
   src = lib.cleanSource ./.;
 
diff --git a/docs/.vitepress/stars.data.ts b/docs/.vitepress/stars.data.ts
index f726e8d09f..eabaeccef7 100644
--- a/docs/.vitepress/stars.data.ts
+++ b/docs/.vitepress/stars.data.ts
@@ -3,7 +3,7 @@
 export default {
   load() {
     return {
-      stars: "19.5k",
+      stars: "19.6k",
     };
   },
 };
diff --git a/docs/cli/activate.md b/docs/cli/activate.md
index 2978709e23..f6844d4f13 100644
--- a/docs/cli/activate.md
+++ b/docs/cli/activate.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise activate`
 
 - **Usage**: `mise activate [FLAGS] [SHELL_TYPE]`
diff --git a/docs/cli/alias.md b/docs/cli/alias.md
index 2ed65c744f..989c7978f2 100644
--- a/docs/cli/alias.md
+++ b/docs/cli/alias.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise alias`
 
 - **Usage**: `mise alias [-p --plugin <PLUGIN>] [--no-header] <SUBCOMMAND>`
diff --git a/docs/cli/alias/get.md b/docs/cli/alias/get.md
index 5951e3622a..1f7cf4fef6 100644
--- a/docs/cli/alias/get.md
+++ b/docs/cli/alias/get.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise alias get`
 
 - **Usage**: `mise alias get <PLUGIN> <ALIAS>`
diff --git a/docs/cli/alias/ls.md b/docs/cli/alias/ls.md
index d64ee7b17e..7e4792bb9d 100644
--- a/docs/cli/alias/ls.md
+++ b/docs/cli/alias/ls.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise alias ls`
 
 - **Usage**: `mise alias ls [--no-header] [TOOL]`
diff --git a/docs/cli/alias/set.md b/docs/cli/alias/set.md
index 772494e323..5e35330e89 100644
--- a/docs/cli/alias/set.md
+++ b/docs/cli/alias/set.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise alias set`
 
 - **Usage**: `mise alias set <ARGS>…`
diff --git a/docs/cli/alias/unset.md b/docs/cli/alias/unset.md
index e3c346b001..ea0b0ba0ad 100644
--- a/docs/cli/alias/unset.md
+++ b/docs/cli/alias/unset.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise alias unset`
 
 - **Usage**: `mise alias unset <PLUGIN> [ALIAS]`
diff --git a/docs/cli/backends.md b/docs/cli/backends.md
index 90cbe3de29..87ad2825ce 100644
--- a/docs/cli/backends.md
+++ b/docs/cli/backends.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise backends`
 
 - **Usage**: `mise backends <SUBCOMMAND>`
diff --git a/docs/cli/backends/ls.md b/docs/cli/backends/ls.md
index 4217fc0acf..debc0a98e1 100644
--- a/docs/cli/backends/ls.md
+++ b/docs/cli/backends/ls.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise backends ls`
 
 - **Usage**: `mise backends ls`
diff --git a/docs/cli/bin-paths.md b/docs/cli/bin-paths.md
index 6d038cb7bb..d4758ba511 100644
--- a/docs/cli/bin-paths.md
+++ b/docs/cli/bin-paths.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise bin-paths`
 
 - **Usage**: `mise bin-paths [TOOL@VERSION]…`
diff --git a/docs/cli/cache.md b/docs/cli/cache.md
index 976d2fcc87..1f32d3ad4d 100644
--- a/docs/cli/cache.md
+++ b/docs/cli/cache.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise cache`
 
 - **Usage**: `mise cache <SUBCOMMAND>`
diff --git a/docs/cli/cache/clear.md b/docs/cli/cache/clear.md
index 16a81cd0a5..a04dce7e7c 100644
--- a/docs/cli/cache/clear.md
+++ b/docs/cli/cache/clear.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise cache clear`
 
 - **Usage**: `mise cache clear [PLUGIN]…`
diff --git a/docs/cli/cache/path.md b/docs/cli/cache/path.md
index c2172d9095..5d34a12df5 100644
--- a/docs/cli/cache/path.md
+++ b/docs/cli/cache/path.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise cache path`
 
 - **Usage**: `mise cache path`
diff --git a/docs/cli/cache/prune.md b/docs/cli/cache/prune.md
index a6f52fd033..1198e87b7b 100644
--- a/docs/cli/cache/prune.md
+++ b/docs/cli/cache/prune.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise cache prune`
 
 - **Usage**: `mise cache prune [--dry-run] [-v --verbose…] [PLUGIN]…`
diff --git a/docs/cli/completion.md b/docs/cli/completion.md
index e33b94c81b..5fb1dfb65a 100644
--- a/docs/cli/completion.md
+++ b/docs/cli/completion.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise completion`
 
 - **Usage**: `mise completion [--include-bash-completion-lib] [SHELL]`
diff --git a/docs/cli/config.md b/docs/cli/config.md
index d29aa3134e..66de3b63a1 100644
--- a/docs/cli/config.md
+++ b/docs/cli/config.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise config`
 
 - **Usage**: `mise config [FLAGS] <SUBCOMMAND>`
diff --git a/docs/cli/config/generate.md b/docs/cli/config/generate.md
index 9c10bdec42..f301362b21 100644
--- a/docs/cli/config/generate.md
+++ b/docs/cli/config/generate.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise config generate`
 
 - **Usage**: `mise config generate [-t --tool-versions <TOOL_VERSIONS>] [-o --output <OUTPUT>]`
diff --git a/docs/cli/config/get.md b/docs/cli/config/get.md
index f28ab423ab..903f867234 100644
--- a/docs/cli/config/get.md
+++ b/docs/cli/config/get.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise config get`
 
 - **Usage**: `mise config get [-f --file <FILE>] [KEY]`
diff --git a/docs/cli/config/ls.md b/docs/cli/config/ls.md
index c74c3bbcfa..6fee8d45f0 100644
--- a/docs/cli/config/ls.md
+++ b/docs/cli/config/ls.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise config ls`
 
 - **Usage**: `mise config ls [FLAGS]`
diff --git a/docs/cli/config/set.md b/docs/cli/config/set.md
index 2901cd11d8..f1f17a7aab 100644
--- a/docs/cli/config/set.md
+++ b/docs/cli/config/set.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise config set`
 
 - **Usage**: `mise config set [-f --file <FILE>] [-t --type <TYPE>] <KEY> <VALUE>`
diff --git a/docs/cli/deactivate.md b/docs/cli/deactivate.md
index 3fe3ec11e0..92f3e5f357 100644
--- a/docs/cli/deactivate.md
+++ b/docs/cli/deactivate.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise deactivate`
 
 - **Usage**: `mise deactivate`
diff --git a/docs/cli/doctor.md b/docs/cli/doctor.md
index 508caa35be..a81e1fdd59 100644
--- a/docs/cli/doctor.md
+++ b/docs/cli/doctor.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise doctor`
 
 - **Usage**: `mise doctor [-J --json] <SUBCOMMAND>`
diff --git a/docs/cli/doctor/path.md b/docs/cli/doctor/path.md
index d4a33c5b54..437a905967 100644
--- a/docs/cli/doctor/path.md
+++ b/docs/cli/doctor/path.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise doctor path`
 
 - **Usage**: `mise doctor path [-f --full]`
diff --git a/docs/cli/en.md b/docs/cli/en.md
index 70d0235126..2acfac7e5b 100644
--- a/docs/cli/en.md
+++ b/docs/cli/en.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise en`
 
 - **Usage**: `mise en [-s --shell <SHELL>] [DIR]`
diff --git a/docs/cli/env.md b/docs/cli/env.md
index 585bb65ab9..04fccb5bc7 100644
--- a/docs/cli/env.md
+++ b/docs/cli/env.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise env`
 
 - **Usage**: `mise env [FLAGS] [TOOL@VERSION]…`
diff --git a/docs/cli/exec.md b/docs/cli/exec.md
index 20f2bda491..a37d5b466a 100644
--- a/docs/cli/exec.md
+++ b/docs/cli/exec.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise exec`
 
 - **Usage**: `mise exec [FLAGS] [TOOL@VERSION]… [-- COMMAND]…`
diff --git a/docs/cli/fmt.md b/docs/cli/fmt.md
index 7e84d33035..fcfae53e68 100644
--- a/docs/cli/fmt.md
+++ b/docs/cli/fmt.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise fmt`
 
 - **Usage**: `mise fmt [FLAGS]`
diff --git a/docs/cli/generate.md b/docs/cli/generate.md
index 23bf73fcf5..49df92527b 100644
--- a/docs/cli/generate.md
+++ b/docs/cli/generate.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise generate`
 
 - **Usage**: `mise generate <SUBCOMMAND>`
diff --git a/docs/cli/generate/bootstrap.md b/docs/cli/generate/bootstrap.md
index a273164009..bb39a35572 100644
--- a/docs/cli/generate/bootstrap.md
+++ b/docs/cli/generate/bootstrap.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise generate bootstrap`
 
 - **Usage**: `mise generate bootstrap [FLAGS]`
diff --git a/docs/cli/generate/config.md b/docs/cli/generate/config.md
index 115563d346..09f5f820ad 100644
--- a/docs/cli/generate/config.md
+++ b/docs/cli/generate/config.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise generate config`
 
 - **Usage**: `mise generate config [-t --tool-versions <TOOL_VERSIONS>] [-o --output <OUTPUT>]`
diff --git a/docs/cli/generate/devcontainer.md b/docs/cli/generate/devcontainer.md
index c3f293e6e9..f3ed12e6d2 100644
--- a/docs/cli/generate/devcontainer.md
+++ b/docs/cli/generate/devcontainer.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise generate devcontainer`
 
 - **Usage**: `mise generate devcontainer [FLAGS]`
diff --git a/docs/cli/generate/git-pre-commit.md b/docs/cli/generate/git-pre-commit.md
index 6d76d483a0..ea5b3c05a9 100644
--- a/docs/cli/generate/git-pre-commit.md
+++ b/docs/cli/generate/git-pre-commit.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise generate git-pre-commit`
 
 - **Usage**: `mise generate git-pre-commit [FLAGS]`
diff --git a/docs/cli/generate/github-action.md b/docs/cli/generate/github-action.md
index 751ba4b349..8a9ebb594e 100644
--- a/docs/cli/generate/github-action.md
+++ b/docs/cli/generate/github-action.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise generate github-action`
 
 - **Usage**: `mise generate github-action [FLAGS]`
diff --git a/docs/cli/generate/task-docs.md b/docs/cli/generate/task-docs.md
index cfd719adb2..f21eff68ae 100644
--- a/docs/cli/generate/task-docs.md
+++ b/docs/cli/generate/task-docs.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise generate task-docs`
 
 - **Usage**: `mise generate task-docs [FLAGS]`
diff --git a/docs/cli/generate/task-stubs.md b/docs/cli/generate/task-stubs.md
index cb25e324e3..3d58a8780e 100644
--- a/docs/cli/generate/task-stubs.md
+++ b/docs/cli/generate/task-stubs.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise generate task-stubs`
 
 - **Usage**: `mise generate task-stubs [-m --mise-bin <MISE_BIN>] [-d --dir <DIR>]`
diff --git a/docs/cli/generate/tool-stub.md b/docs/cli/generate/tool-stub.md
index 5d44cf7df3..6cd47af2b3 100644
--- a/docs/cli/generate/tool-stub.md
+++ b/docs/cli/generate/tool-stub.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise generate tool-stub`
 
 - **Usage**: `mise generate tool-stub [FLAGS] <OUTPUT>`
diff --git a/docs/cli/implode.md b/docs/cli/implode.md
index b83ad8203b..0096aa851b 100644
--- a/docs/cli/implode.md
+++ b/docs/cli/implode.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise implode`
 
 - **Usage**: `mise implode [--config] [-n --dry-run]`
diff --git a/docs/cli/index.md b/docs/cli/index.md
index ab73e2eed1..fa42ed646d 100644
--- a/docs/cli/index.md
+++ b/docs/cli/index.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise`
 
 **Usage**: `mise [FLAGS] [TASK] <SUBCOMMAND>`
diff --git a/docs/cli/install-into.md b/docs/cli/install-into.md
index 236a401273..b2dfaaae9c 100644
--- a/docs/cli/install-into.md
+++ b/docs/cli/install-into.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise install-into`
 
 - **Usage**: `mise install-into <TOOL@VERSION> <PATH>`
diff --git a/docs/cli/install.md b/docs/cli/install.md
index de5983db19..76fb98e835 100644
--- a/docs/cli/install.md
+++ b/docs/cli/install.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise install`
 
 - **Usage**: `mise install [FLAGS] [TOOL@VERSION]…`
diff --git a/docs/cli/latest.md b/docs/cli/latest.md
index 21a4e0b191..190328abb8 100644
--- a/docs/cli/latest.md
+++ b/docs/cli/latest.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise latest`
 
 - **Usage**: `mise latest [-i --installed] <TOOL@VERSION>`
diff --git a/docs/cli/link.md b/docs/cli/link.md
index 467138cace..7186e081c5 100644
--- a/docs/cli/link.md
+++ b/docs/cli/link.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise link`
 
 - **Usage**: `mise link [-f --force] <TOOL@VERSION> <PATH>`
diff --git a/docs/cli/lock.md b/docs/cli/lock.md
index d6b85fb524..441fc096d8 100644
--- a/docs/cli/lock.md
+++ b/docs/cli/lock.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise lock`
 
 - **Usage**: `mise lock [FLAGS] [TOOL]…`
diff --git a/docs/cli/ls-remote.md b/docs/cli/ls-remote.md
index 441dd91120..effe4a6d9f 100644
--- a/docs/cli/ls-remote.md
+++ b/docs/cli/ls-remote.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise ls-remote`
 
 - **Usage**: `mise ls-remote [--all] [TOOL@VERSION] [PREFIX]`
diff --git a/docs/cli/ls.md b/docs/cli/ls.md
index 943f8d9155..07c65f76c9 100644
--- a/docs/cli/ls.md
+++ b/docs/cli/ls.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise ls`
 
 - **Usage**: `mise ls [FLAGS] [INSTALLED_TOOL]…`
diff --git a/docs/cli/mcp.md b/docs/cli/mcp.md
index 42ad71c9c0..35d1957d18 100644
--- a/docs/cli/mcp.md
+++ b/docs/cli/mcp.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise mcp`
 
 - **Usage**: `mise mcp`
diff --git a/docs/cli/outdated.md b/docs/cli/outdated.md
index a35b4c886c..6ae9bcfeb6 100644
--- a/docs/cli/outdated.md
+++ b/docs/cli/outdated.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise outdated`
 
 - **Usage**: `mise outdated [FLAGS] [TOOL@VERSION]…`
diff --git a/docs/cli/plugins.md b/docs/cli/plugins.md
index 8ad47802ee..0bd779ca27 100644
--- a/docs/cli/plugins.md
+++ b/docs/cli/plugins.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise plugins`
 
 - **Usage**: `mise plugins [FLAGS] <SUBCOMMAND>`
diff --git a/docs/cli/plugins/install.md b/docs/cli/plugins/install.md
index 7365c851f8..fe9175cefb 100644
--- a/docs/cli/plugins/install.md
+++ b/docs/cli/plugins/install.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise plugins install`
 
 - **Usage**: `mise plugins install [FLAGS] [NEW_PLUGIN] [GIT_URL]`
diff --git a/docs/cli/plugins/link.md b/docs/cli/plugins/link.md
index 8148b7f77c..23525edea0 100644
--- a/docs/cli/plugins/link.md
+++ b/docs/cli/plugins/link.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise plugins link`
 
 - **Usage**: `mise plugins link [-f --force] <NAME> [DIR]`
diff --git a/docs/cli/plugins/ls-remote.md b/docs/cli/plugins/ls-remote.md
index 44bb27a18d..fb723f4be4 100644
--- a/docs/cli/plugins/ls-remote.md
+++ b/docs/cli/plugins/ls-remote.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise plugins ls-remote`
 
 - **Usage**: `mise plugins ls-remote [-u --urls] [--only-names]`
diff --git a/docs/cli/plugins/ls.md b/docs/cli/plugins/ls.md
index 522e812df4..5146865485 100644
--- a/docs/cli/plugins/ls.md
+++ b/docs/cli/plugins/ls.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise plugins ls`
 
 - **Usage**: `mise plugins ls [-u --urls]`
diff --git a/docs/cli/plugins/uninstall.md b/docs/cli/plugins/uninstall.md
index 12d1e82f32..15ac065777 100644
--- a/docs/cli/plugins/uninstall.md
+++ b/docs/cli/plugins/uninstall.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise plugins uninstall`
 
 - **Usage**: `mise plugins uninstall [-p --purge] [-a --all] [PLUGIN]…`
diff --git a/docs/cli/plugins/update.md b/docs/cli/plugins/update.md
index a0a3d7d482..b47238c041 100644
--- a/docs/cli/plugins/update.md
+++ b/docs/cli/plugins/update.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise plugins update`
 
 - **Usage**: `mise plugins update [-j --jobs <JOBS>] [PLUGIN]…`
diff --git a/docs/cli/prune.md b/docs/cli/prune.md
index 4bab6b0829..9fdcde34c7 100644
--- a/docs/cli/prune.md
+++ b/docs/cli/prune.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise prune`
 
 - **Usage**: `mise prune [FLAGS] [INSTALLED_TOOL]…`
diff --git a/docs/cli/registry.md b/docs/cli/registry.md
index 2125410204..1c23a5c6b3 100644
--- a/docs/cli/registry.md
+++ b/docs/cli/registry.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise registry`
 
 - **Usage**: `mise registry [-b --backend <BACKEND>] [--hide-aliased] [NAME]`
diff --git a/docs/cli/reshim.md b/docs/cli/reshim.md
index 63ec77aa49..396cd75368 100644
--- a/docs/cli/reshim.md
+++ b/docs/cli/reshim.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise reshim`
 
 - **Usage**: `mise reshim [-f --force]`
diff --git a/docs/cli/run.md b/docs/cli/run.md
index e0d692787b..fe7a367892 100644
--- a/docs/cli/run.md
+++ b/docs/cli/run.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise run`
 
 - **Usage**: `mise run [FLAGS]`
diff --git a/docs/cli/search.md b/docs/cli/search.md
index d69440a404..a5764ea3b1 100644
--- a/docs/cli/search.md
+++ b/docs/cli/search.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise search`
 
 - **Usage**: `mise search [FLAGS] [NAME]`
diff --git a/docs/cli/self-update.md b/docs/cli/self-update.md
index 0e35e10cc2..b73df5ad0f 100644
--- a/docs/cli/self-update.md
+++ b/docs/cli/self-update.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise self-update`
 
 - **Usage**: `mise self-update [FLAGS] [VERSION]`
diff --git a/docs/cli/set.md b/docs/cli/set.md
index 76d5538ed7..a4af8e5fcb 100644
--- a/docs/cli/set.md
+++ b/docs/cli/set.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise set`
 
 - **Usage**: `mise set [FLAGS] [ENV_VAR]…`
diff --git a/docs/cli/settings.md b/docs/cli/settings.md
index 2d69543b5d..ee414fca41 100644
--- a/docs/cli/settings.md
+++ b/docs/cli/settings.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise settings`
 
 - **Usage**: `mise settings [FLAGS] [SETTING] [VALUE] <SUBCOMMAND>`
diff --git a/docs/cli/settings/add.md b/docs/cli/settings/add.md
index 532b6ac0e7..155af6f97d 100644
--- a/docs/cli/settings/add.md
+++ b/docs/cli/settings/add.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise settings add`
 
 - **Usage**: `mise settings add [-l --local] <SETTING> <VALUE>`
diff --git a/docs/cli/settings/get.md b/docs/cli/settings/get.md
index 57032f4f6d..fa6d31ca78 100644
--- a/docs/cli/settings/get.md
+++ b/docs/cli/settings/get.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise settings get`
 
 - **Usage**: `mise settings get [-l --local] <SETTING>`
diff --git a/docs/cli/settings/ls.md b/docs/cli/settings/ls.md
index 437e860af5..1d048245cd 100644
--- a/docs/cli/settings/ls.md
+++ b/docs/cli/settings/ls.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise settings ls`
 
 - **Usage**: `mise settings ls [FLAGS] [SETTING]`
diff --git a/docs/cli/settings/set.md b/docs/cli/settings/set.md
index 20e8909099..2ae36df1d3 100644
--- a/docs/cli/settings/set.md
+++ b/docs/cli/settings/set.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise settings set`
 
 - **Usage**: `mise settings set [-l --local] <SETTING> <VALUE>`
diff --git a/docs/cli/settings/unset.md b/docs/cli/settings/unset.md
index d3c9b3583b..98606d143c 100644
--- a/docs/cli/settings/unset.md
+++ b/docs/cli/settings/unset.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise settings unset`
 
 - **Usage**: `mise settings unset [-l --local] <KEY>`
diff --git a/docs/cli/shell.md b/docs/cli/shell.md
index e329a82227..234d544c1f 100644
--- a/docs/cli/shell.md
+++ b/docs/cli/shell.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise shell`
 
 - **Usage**: `mise shell [FLAGS] <TOOL@VERSION>…`
diff --git a/docs/cli/sync.md b/docs/cli/sync.md
index e6e5799966..2022f4ee52 100644
--- a/docs/cli/sync.md
+++ b/docs/cli/sync.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise sync`
 
 - **Usage**: `mise sync <SUBCOMMAND>`
diff --git a/docs/cli/sync/node.md b/docs/cli/sync/node.md
index fd11dcace7..5c00bfe7d3 100644
--- a/docs/cli/sync/node.md
+++ b/docs/cli/sync/node.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise sync node`
 
 - **Usage**: `mise sync node [FLAGS]`
diff --git a/docs/cli/sync/python.md b/docs/cli/sync/python.md
index e5f3636835..bc1aabaeb3 100644
--- a/docs/cli/sync/python.md
+++ b/docs/cli/sync/python.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise sync python`
 
 - **Usage**: `mise sync python [--pyenv] [--uv]`
diff --git a/docs/cli/sync/ruby.md b/docs/cli/sync/ruby.md
index 854b243a70..f5c5afd644 100644
--- a/docs/cli/sync/ruby.md
+++ b/docs/cli/sync/ruby.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise sync ruby`
 
 - **Usage**: `mise sync ruby [--brew]`
diff --git a/docs/cli/tasks.md b/docs/cli/tasks.md
index e624266df3..f385c64b1e 100644
--- a/docs/cli/tasks.md
+++ b/docs/cli/tasks.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise tasks`
 
 - **Usage**: `mise tasks [FLAGS] [TASK] <SUBCOMMAND>`
diff --git a/docs/cli/tasks/add.md b/docs/cli/tasks/add.md
index 2ecf7edc32..95024b445d 100644
--- a/docs/cli/tasks/add.md
+++ b/docs/cli/tasks/add.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise tasks add`
 
 - **Usage**: `mise tasks add [FLAGS] <TASK> [-- RUN]…`
diff --git a/docs/cli/tasks/deps.md b/docs/cli/tasks/deps.md
index d6ebda34d4..3db53f6553 100644
--- a/docs/cli/tasks/deps.md
+++ b/docs/cli/tasks/deps.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise tasks deps`
 
 - **Usage**: `mise tasks deps [--hidden] [--dot] [TASKS]…`
diff --git a/docs/cli/tasks/edit.md b/docs/cli/tasks/edit.md
index 4be1cafc39..96f4477bae 100644
--- a/docs/cli/tasks/edit.md
+++ b/docs/cli/tasks/edit.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise tasks edit`
 
 - **Usage**: `mise tasks edit [-p --path] <TASK>`
diff --git a/docs/cli/tasks/info.md b/docs/cli/tasks/info.md
index ebad5ec193..f048347957 100644
--- a/docs/cli/tasks/info.md
+++ b/docs/cli/tasks/info.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise tasks info`
 
 - **Usage**: `mise tasks info [-J --json] <TASK>`
diff --git a/docs/cli/tasks/ls.md b/docs/cli/tasks/ls.md
index 183ffdf099..7a78ea6f9a 100644
--- a/docs/cli/tasks/ls.md
+++ b/docs/cli/tasks/ls.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise tasks ls`
 
 - **Usage**: `mise tasks ls [FLAGS]`
diff --git a/docs/cli/tasks/run.md b/docs/cli/tasks/run.md
index 131ea49e41..7923c02957 100644
--- a/docs/cli/tasks/run.md
+++ b/docs/cli/tasks/run.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise tasks run`
 
 - **Usage**: `mise tasks run [FLAGS] [TASK] [ARGS]…`
diff --git a/docs/cli/test-tool.md b/docs/cli/test-tool.md
index 6f73e2621c..85c0a31070 100644
--- a/docs/cli/test-tool.md
+++ b/docs/cli/test-tool.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise test-tool`
 
 - **Usage**: `mise test-tool [FLAGS] [TOOLS]…`
diff --git a/docs/cli/tool-stub.md b/docs/cli/tool-stub.md
index 6055971a48..013f4167e8 100644
--- a/docs/cli/tool-stub.md
+++ b/docs/cli/tool-stub.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise tool-stub`
 
 - **Usage**: `mise tool-stub <FILE> [ARGS]…`
diff --git a/docs/cli/tool.md b/docs/cli/tool.md
index 476f55ba51..6c5068499c 100644
--- a/docs/cli/tool.md
+++ b/docs/cli/tool.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise tool`
 
 - **Usage**: `mise tool [FLAGS] <TOOL>`
diff --git a/docs/cli/trust.md b/docs/cli/trust.md
index f34b9095a6..f10a0647d4 100644
--- a/docs/cli/trust.md
+++ b/docs/cli/trust.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise trust`
 
 - **Usage**: `mise trust [FLAGS] [CONFIG_FILE]`
diff --git a/docs/cli/uninstall.md b/docs/cli/uninstall.md
index 4d109cfdf1..af135a985c 100644
--- a/docs/cli/uninstall.md
+++ b/docs/cli/uninstall.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise uninstall`
 
 - **Usage**: `mise uninstall [-a --all] [-n --dry-run] [INSTALLED_TOOL@VERSION]…`
diff --git a/docs/cli/unset.md b/docs/cli/unset.md
index 282f79b509..833c215e3f 100644
--- a/docs/cli/unset.md
+++ b/docs/cli/unset.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise unset`
 
 - **Usage**: `mise unset [-f --file <FILE>] [-g --global] [ENV_KEY]…`
diff --git a/docs/cli/unuse.md b/docs/cli/unuse.md
index 0ba405c4f0..a913e536f6 100644
--- a/docs/cli/unuse.md
+++ b/docs/cli/unuse.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise unuse`
 
 - **Usage**: `mise unuse [FLAGS] <INSTALLED_TOOL@VERSION>…`
diff --git a/docs/cli/upgrade.md b/docs/cli/upgrade.md
index e115214ba3..94f0e8013f 100644
--- a/docs/cli/upgrade.md
+++ b/docs/cli/upgrade.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise upgrade`
 
 - **Usage**: `mise upgrade [FLAGS] [TOOL@VERSION]…`
diff --git a/docs/cli/use.md b/docs/cli/use.md
index 4b2e2380c6..6e1fa0fc0b 100644
--- a/docs/cli/use.md
+++ b/docs/cli/use.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise use`
 
 - **Usage**: `mise use [FLAGS] [TOOL@VERSION]…`
diff --git a/docs/cli/version.md b/docs/cli/version.md
index de455aadd7..32c1623c97 100644
--- a/docs/cli/version.md
+++ b/docs/cli/version.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise version`
 
 - **Usage**: `mise version [-J --json]`
diff --git a/docs/cli/watch.md b/docs/cli/watch.md
index 37c4ebf077..ceaa5a9d81 100644
--- a/docs/cli/watch.md
+++ b/docs/cli/watch.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise watch`
 
 - **Usage**: `mise watch [FLAGS] [TASK] [ARGS]…`
diff --git a/docs/cli/where.md b/docs/cli/where.md
index d869fb44a9..c1bff736ef 100644
--- a/docs/cli/where.md
+++ b/docs/cli/where.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise where`
 
 - **Usage**: `mise where <TOOL@VERSION>`
diff --git a/docs/cli/which.md b/docs/cli/which.md
index 578d0b5615..6c83a51a06 100644
--- a/docs/cli/which.md
+++ b/docs/cli/which.md
@@ -1,3 +1,4 @@
+<!-- @generated by usage-cli from usage spec -->
 # `mise which`
 
 - **Usage**: `mise which [FLAGS] [BIN_NAME]`
diff --git a/mise.lock b/mise.lock
index 2499786c29..1e3abf62f2 100644
--- a/mise.lock
+++ b/mise.lock
@@ -68,7 +68,7 @@ version = "0.2.3"
 backend = "cargo:toml-cli"
 
 [[tools."cargo:usage-cli"]]
-version = "2.2.2"
+version = "2.3.0"
 backend = "cargo:usage-cli"
 
 [[tools.cosign]]
diff --git a/packaging/rpm/mise.spec b/packaging/rpm/mise.spec
index 348df12be4..35991fe50e 100644
--- a/packaging/rpm/mise.spec
+++ b/packaging/rpm/mise.spec
@@ -1,6 +1,6 @@
 Summary: The front-end to your dev env
 Name: mise
-Version: 2025.9.21
+Version: 2025.9.22
 Release: 1
 URL: https://github.com/jdx/mise/
 Group: System
diff --git a/xtasks/fig/src/mise.ts b/xtasks/fig/src/mise.ts
index c8c5b82cc7..fa0c3bf689 100644
--- a/xtasks/fig/src/mise.ts
+++ b/xtasks/fig/src/mise.ts
@@ -1,3 +1,4 @@
+// @generated by usage-cli from mise.usage.kdl
 const envVarGenerator = {
   script: ["sh", "-c", "env"],
   postProcess: (output: string) => {