If you switch between development projects which expect different environments, specifically different runtime versions or ambient libraries,
or you are tired of all kinds of cumbersome environment configurations, vfox
is the ideal choice for you.
vfox
is a cross-platform version manager(similar to nvm
, fvm
, sdkman
, asdf-vm
, etc.), extendable via plugins. It allows you to quickly install
and switch between different environment you need via the command line.
- cross-platform support (Windows, Linux, macOS)
- single CLI for multiple languages
- consistent commands to manage all your languages
- support Global、Project、Session scopes when switching versions
- simple plugin system to add support for your language of choice
- automatically switches runtime versions as you traverse your project
- shell completion available for common shells (Bash, ZSH, Powershell)
- it's faster than
asdf-vm
, and offers more simple commands and genuine cross-platform unification. see Comparison with asdf
For detailed installation instructions, see Quick Start
1. Choose an installation that works for you.
echo 'eval "$(vfox activate bash)"' >> ~/.bashrc
echo 'eval "$(vfox activate zsh)"' >> ~/.zshrc
echo 'vfox activate fish | source' >> ~/.config/fish/config.fish
# For PowerShell:
# 1. Open PowerShell Profile:
New-Item -Type File -Path $PROFILE # Just ignore the 'file already exists' error.
Invoke-Item $PROFILE
# 2. Add the following line to the end of your $PROFILE and save:
Invoke-Expression "$(vfox activate pwsh)"
Remember to restart your shell to apply the changes.
$ vfox add nodejs/nodejs
$ vfox install nodejs@21.5.0
$ vfox use nodejs@21.5.0
$ node -v
21.5.0
See vfox.lhan.me for full documentation.
If you have installed
vfox
, you can view all available plugins with thevfox available
command.
For more details, see the version-fox-plugins
Thanks to following people who contributed to this project. 🎉🎉🙏🙏
Bug reports, contributions and forks are welcome. All bugs or other forms of discussion happen on issues.
See more at CONTRIBUTING.md.
Plugin Contributions, please go to version-fox-plugins.
Apache 2.0 license - Copyright (C) 2024 Han Li and contributors