zigvm

Version manager for the Zig Programming Language.

It lets you install and manage your Zig installation.

zigvm is in early stages of its development, it can do basic things and platform support may not be on par with other version managers. If you encounter issues or want to request a feature be sure to drop a issue on the GitHub issue tracker.

Platform Support

Legend:
🎉 - Binary releases + automatic installer available
💪 - binary releases available
❌ - No binary releases. Maybe supported later. Requires compiling
- - Not applicable

OS/Arch	x86_64	x86	aarch64	armv7a	riscv64
Windows	💪	💪	❌	-	-
Linux	🎉	🎉	🎉	❌	❌
MacOS	🎉	-	🎉	-	-

Installation

For Linux and MacOS (x86_64+aarch64)

You can use this automated install script which will install zigvm along with the latest version of Zig

curl --proto '=https' --tlsv1.2 -sSf https://raw.githubusercontent.com/AMythicDev/zigvm/main/scripts/install.sh | sh

By default it will create $HOME/.zigvm directory as the root folder for zigvm. You can customize this by setting this by setting the ZIGVM_ROOT_DIR to the directory where you want to install zigvm. Make sire you add the ZIGVM_ROOT_DIR in your shell config otherwise zigvm would not be able to locate the installation folder.

The script will also put the installation directory's bin folder to your $PATH variable. For this it will append a line to your $HOME/.profile and your shell's rc file. The file for each shell supported is listed below:

• Bash: $HOME/.bashrc
• Zsh: $HOME/.zshrc
• Fish: $XDG_CONFIG_HOME/fish/config.fish, if not set then uses $HOME/.config/fish/config.fish

For Windows

• Create the following folder structure in C:\Users\[YOU-USERNAME]\.zigvm:

.
├── bin
├── downloads
└── installs

• Download the latest release for Windows from GitHub and extract it.
• Copy zigvm.exe and zig.exe to the bin/ folder.
• Ass the bin directory to your PATH enviroment variable

Compiling

Requirements:

• Zig >= 0.12.0
• libc on non-Windows systems. Can be provided by Zig itself, if available for the platform.
• git, if you want to compile the latest commit or you want to develop zigvm.

Now to compile:

• Clone the repo or download a source archive depending on if you want to compile the latest main branck or a release.
• Extract the archive and change into the extracted directory.
• Run the following command

zig build --release=safe

• If you are devloping zigvm, you can omit the --release=safe flag.
• You will have zigvm and zig in zig-out/bin/ directory
• Lastly follow the same steps for windows

Features

• Install versions (master, stable, x.y.z)
• Continue download if previously interrupted
• Remove versions
• List down installed versions
• Manage default and per-directory version overrides
• Tries to maintain strong compatiblity with the wider zig ecosystem (zls, zig.vim)

License

zigvm is licensed under the Apache License 2.0. See the LICENSE file.