Skip to content

Help & Version

Print global help information by running:

Terminal window
zvm --help

Print help information about a specific command or subcommand.

Terminal window
zvm list --help
NAME:
zvm list - list installed Zig versions. Flag `--all` to see remote options
USAGE:
zvm list [command options] [arguments...]
OPTIONS:
--all, -a list remote Zig versions available for download, based on your version map (default: false)
--vmu list set version maps (default: false)
--help, -h show help
Terminal window
zvm --version
zvm version # same output — added in v0.8.19

Both forms print the version of ZVM you have installed. The version subcommand was added for tooling and shells that parse subcommands but not global flags.

ZVM can emit a completion script for bash, zsh, fish, or pwsh (PowerShell). The script is generated from ZVM’s live command tree, so it always reflects the commands and flags of the zvm binary you ran it with.

Terminal window
zvm completion bash
zvm completion zsh
zvm completion fish
zvm completion pwsh

Source the script for the current session:

Terminal window
source <(zvm completion bash)

To load it on every new shell, write it to bash-completion’s load path:

Terminal window
zvm completion bash > /etc/bash_completion.d/zvm # system-wide
# or for a single user:
zvm completion bash > ~/.local/share/bash-completion/completions/zvm

Place the script somewhere on your $fpath as _zvm:

Terminal window
zvm completion zsh > "${fpath[1]}/_zvm"

Then ensure compinit is running in your ~/.zshrc:

Terminal window
autoload -Uz compinit && compinit
Terminal window
zvm completion fish > ~/.config/fish/completions/zvm.fish

Fish picks this up automatically on the next shell.

Terminal window
zvm completion pwsh > $PROFILE.CurrentUserAllHosts\..\zvm.ps1

Then dot-source the file from your PowerShell profile ($PROFILE):

Terminal window
. "$HOME\Documents\PowerShell\zvm.ps1"