https://github.com/xoltia/zi
A Zig/ZLS installer
https://github.com/xoltia/zi
installer version-manager zig
Last synced: 15 days ago
JSON representation
A Zig/ZLS installer
- Host: GitHub
- URL: https://github.com/xoltia/zi
- Owner: xoltia
- License: mit
- Created: 2025-05-03T17:51:50.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2025-07-31T18:06:58.000Z (7 months ago)
- Last Synced: 2025-07-31T21:51:35.682Z (7 months ago)
- Topics: installer, version-manager, zig
- Language: Zig
- Homepage:
- Size: 90.8 KB
- Stars: 18
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# zi: a zig installer
zi is a basic tool that helps you install specific versions of Zig from the official index.
It can also install ZLS, either from GitHub releases or by building it from source for use with the latest Zig version.
## Examples
Basic usage: installs from any mirror, first checking if a local install already exists.
```
zi install 0.14.0
```
Force install (maybe necessary if a previous install failed) Zig from the Mach Engine mirror, without trying to also download ZLS.
```
zi install 0.14.1 -f --mirror=https://pkg.machengine.org/zig --skip-zls
```
Mismatched Zig/ZLS versions. Useful if there is no matching ZLS version (such as with 0.14.1).
```
zi install 0.14.0
zi install 0.14.1 --skip-zls
zi use 0.14.0 --zls
```
## Usage
```
zi is a simple Zig version manager.
Usage:
zi [OPTIONS] [SUBCOMMAND]
Subcommands:
ls List Zig versions
ls-mirrors List available mirrors
install Install a specific remote Zig version
use [version] Switch to a specific local Zig version,
using .zirc if version is omitted
Flags:
-h, --help Print help information
-V, --version Print version information
Flags for `ls` subcommand:
-r, --remote List only remote versions
-l, --local List only local versions
Flags for `install` subcommand:
-f, --force Remove the existing download if it exists
--mirror= Use a specific mirror (must be in the community-mirrors.txt
format; see https://ziglang.org/download/community-mirrors)
--no-mirror Download directly from ziglang.org (not recommended)
-s, --skip-zls Skip downloading and/or linking the ZLS executable
Flags for `use` subcommand:
--zls Change only the ZLS version, useful for mismatching ZLS
and Zig versions
Environment variables:
ZI_INSTALL_DIR Directory to install Zig versions (default: $HOME/.zi)
ZI_LINK_DIR Directory to create symlinks for the active Zig version
(default: $HOME/.local/bin)
```