Zim is a cli tool to download and manages multiple versions of zig and zls.
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-10-18 19:59:29 +02:00
src update usage of deprecated apis 2026-10-18 19:59:29 +02:00
.gitignore add ping time detection for mirrors 2026-05-16 19:24:29 +02:00
build.zig update usage of deprecated apis 2026-10-18 19:59:29 +02:00
build.zig.zon 0.2.0 2026-10-18 19:20:31 +02:00
README.md add completion for powershell 2026-10-18 18:50:09 +02:00

ZIM - Zig installation manager

Zim is a cli tool to download and manage multiple versions of zig and zls.

info: Usage: zim <command> [args]

Commands:
  install, i     Download a Zig version
  use, u         Select an installed version
  list, ls       List installed zig versions
  remove, rm     Delete a installed version
  help, h        Show this message

General options:
  -h, --help     Show command-specific usage
Usage: zim install <version> [options]

Fetch a version of Zig (and optionally ZLS) and select it
as the active version. <version> is a semver like `0.14.1`
or `master`.

Options:
  --zls          Also install ZLS
  --force        Re-install if already present
  -h, --help     Show this help
> zim i 0.16.0 --zls
[3] zim
├─ installing zig-x86_64-linux-0.16.0.tar.xz from https://zig-mirror.tsimnet.eu/zig
└─ [84/100] extract

Installation

Downlaod the Zim executable from the release page or compile from source. Place the zim executable somewhere on your PATH.

Add the symlink directory to your PATH:

export PATH="/path/to/zim-data/bin:$PATH"

The zim-data directory is created next to the zim executable and holds all fetched versions and the active symlinks.

Autocomplete

Zim ships with a built-in completion provider. To use completion add the appropriate lines to your shell's startup file.

Bash

complete -C 'zim bash-complete' zim

Add it to ~/.bashrc (Linux) or ~/.bash_profile (macOS).

Zsh

autoload -U +X bashcompinit && bashcompinit
complete -C 'zim bash-complete' zim

Add it to ~/.zshrc. This is the right setup for the default shell on macOS.

PowerShell

zim powershell-complete-script | Out-String | Invoke-Expression

Add it to $PROFILE. If if $PROFILE doesnt exist first create it with with New-Item -Force $PROFILE.