A script to manage your Zig versions.

First, make sure ZVM_BIN is on your PATH. By default, it's ~/.local/bin:¹

• On Linux, /home/<username>/.local/bin
• On Windows, C:\Users\<username>\.local\bin
• On MacOS, /Users/<username>/.local/bin

Next, determine if you need to explicitly set your target. On Linux you probably won't have to, put if you're on Windows or MacOS, see the Cross-platform support section below.

• A POSIX-compliant shell
• curl
• jq
• tar
• unzip

Without any commands, zvm will print the currently active Zig version and exit. Specific actions may be performed my providing a command.

Alias: ls

List Zig versions from the remote index:

zvm list

List installed Zig versions:

zvm list -i
zvm list --installed

Alias: i

Install a Zig version:

zvm install 0.12.0

Install a Zig version and make it active immediately:

zvm install -u 0.12.0
zvm install --use 0.12.0

Use an installed Zig version:

zvm use 0.12.0

Alias: rm

Uninstall a Zig version:

zvm uninstall 0.11.0

Alias: h

Show zvm help:

zvm help

• ZVM_HOME - zvm home directory (where zvm downloads and extracts Zig tarballs)
• ZVM_BIN - zvm bin directory (where zvm links Zig binaries)

• Support building from source?
• Allow custom download location (default: $HOME/.local/share/zvm)
  • 9b1afd4
• Allow custom install prefix (default: $HOME/.local/bin/zig)
  • 9b1afd4

Native support. zvm's detected native target will likely work, but you can override it if you need to.

Supported via various Linux subsystems (git-bash, WSL, etc.).

zvm uses uname to detect the target and it currently only uses what uname provides, which will differ depending on the Linux subsystem used (git-bash, WSL, mingw, etc). However, Zig's targets use windows as the OS name. Due to this, for now you'll have to explicitly set your target:

zvm --target <arch>-windows

Replace <arch> with one of the following:

• On a 32-bit system, x86 (e.g. x86-windows)
• On a 64-bit x86 system, x86-64 (e.g. x86_64-windows)
• On a 64-bit aarch64 system, aarch64 (e.g. aarch64-windows)

Supported natively but shares the same gotchas as the Windows support.

zvm uses uname to detect the target and it currently only uses what uname provides. However, Zig's targets use macos as the OS name instead of darwin, which is what uname will return. Due to this, for now you'll have to explicitly set your target:

zvm --target <arch>-macos

Replace <arch> with one of the following:

• On a 64-bit x86 system, x86-64 (e.g. x86_64-macos)
• On a 64-bit aarch64 system (a.k.a 'Apple silicon'), aarch64 (e.g. aarch64-macos)