The ZSH version manager
WARNING: Although the majority of zvm's functionality works as expected, it is in the early stages of development, and as such bugs are likely to be present. Please continue with caution, and report any issues you may have.
- GCC and Make (Installed by default on OSX. For Ubuntu, run
sudo apt-get install build-essential autoconf ncurses-dev yodl)
Zulu will automatically install dependencies and the shell integration for you.
zulu install zvm
git clone https://github.com/molovo/zvm zvm ln -s "$PWD/zvm/zvm" /usr/local/bin echo "source $PWD/zvm/zvm-shell-integration.zsh" >> ~/.zshrc
By default, zvm stores the ZSH source and compiled binaries in
~/.zvm. If you'd like to store it somewhere else, set
$ZVM_DIR to an absolute path in
~/.zshrc before you run zvm for the first time.
The first time you run
zvm use or
zvm install, zvm will check for and download the ZSH source, and set up its internal directory structure.
Listing available versions
# List all stable versions zvm list # List only installed versions zvm list --installed # Include pre-release versions in results zvm list --prerelease
# Use the default version zvm use # Use the specified version. It will be compiled and installed if # it hasn't been already zvm use 5.3.1 # Show the default zvm default # Show the current version zvm current # Set the default to a new version. It will be compiled and installed if # it hasn't been already zvm default 4.3.12 # Install a new version without selecting it zvm install 5.0.2
Using different versions on a per-project basis
You can set the ZSH version for a specific project by running
zvm dir <version> within the project's directory, which will create a
.zvmrc file in the current directory. If you run
zvm use without specifying a version in a directory with a
.zvmrc file, it will automatically choose the version specified in
Using per-project versions automatically.
ZVM_AUTO_USE=1 adds a hook which automatically changes the version when you
cd into a directory with a
Copyright (c) 2016 James Dinsdale email@example.com (molovo.co)
zvm is licensed under The MIT License (MIT)