Skip to content

docs(vfox): replace deprecated asdf and vfox settings with disable_backends #5652

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
jdx merged 1 commit into from
Jul 16, 2025
Merged

docs(vfox): replace deprecated asdf and vfox settings with disable_backends #5652

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
42 changes: 18 additions & 24 deletions docs/dev-tools/backends/vfox.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -27,38 +27,32 @@ The version will be set in `~/.config/mise/config.toml` with the following forma

## Default plugin backend

If you'd like to use plugins by default like on Windows, set the following settings:
On Windows, mise uses vfox plugins by default.
If you'd like to use plugins by default even on Linux/macOS, set the following settings:

```sh
mise settings asdf=false
mise settings vfox=true
mise settings add disable_backends asdf
```

Copilot AI Jul 15, 2025

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The documentation should clarify what the disable_backends setting does and why disabling asdf is equivalent to the previous asdf=false vfox=true combination. Consider adding a brief explanation of how this setting affects backend priority.

Suggested change
The `disable_backends` setting allows you to disable specific backends, such as `asdf`, which changes the priority of backends used by mise. When `asdf` is disabled, mise defaults to using `vfox` for plugin management, effectively resulting in the `asdf=false vfox=true` combination. This ensures that vfox plugins are prioritized over asdf plugins for tool installation and management.
Backend priority determines which backend is used when multiple backends support the same tool. By disabling a backend, you remove it from consideration, allowing mise to prioritize other available backends. For example, disabling `asdf` ensures that vfox plugins are used exclusively for tools supported by both `asdf` and `vfox`.

Copilot uses AI. Check for mistakes.
Now you can list available plugins with `mise registry`:

```sh
$ mise registry | grep vfox:
clang vfox:version-fox/vfox-clang
cmake vfox:version-fox/vfox-cmake
crystal vfox:yanecc/vfox-crystal
dart vfox:version-fox/vfox-dart
dotnet vfox:version-fox/vfox-dotnet
elixir vfox:version-fox/vfox-elixir
etcd vfox:version-fox/vfox-etcd
flutter vfox:version-fox/vfox-flutter
golang vfox:version-fox/vfox-golang
gradle vfox:version-fox/vfox-gradle
groovy vfox:version-fox/vfox-groovy
julia vfox:ahai-code/vfox-julia
kotlin vfox:version-fox/vfox-kotlin
kubectl vfox:ahai-code/vfox-kubectl
maven vfox:version-fox/vfox-maven
mongo vfox:yeshan333/vfox-mongo
php vfox:version-fox/vfox-php
protobuf vfox:ahai-code/vfox-protobuf
scala vfox:version-fox/vfox-scala
terraform vfox:enochchau/vfox-terraform
vlang vfox:ahai-code/vfox-vlang
clang vfox:mise-plugins/vfox-clang
cmake vfox:mise-plugins/vfox-cmake
crystal vfox:mise-plugins/vfox-crystal
dart vfox:mise-plugins/vfox-dart
dotnet vfox:mise-plugins/vfox-dotnet
etcd aqua:etcd-io/etcd vfox:mise-plugins/vfox-etcd
flutter vfox:mise-plugins/vfox-flutter
gradle aqua:gradle/gradle vfox:mise-plugins/vfox-gradle
groovy vfox:mise-plugins/vfox-groovy
kotlin vfox:mise-plugins/vfox-kotlin
maven aqua:apache/maven vfox:mise-plugins/vfox-maven
php vfox:mise-plugins/vfox-php
scala vfox:mise-plugins/vfox-scala
terraform aqua:hashicorp/terraform vfox:mise-plugins/vfox-terraform
vlang vfox:mise-plugins/vfox-vlang
```

And they will be installed when running commands such as `mise use -g cmake` without needing to
Expand Down
Loading