Installation

Klim supports macOS, Linux, and Windows. Pre-built binaries are published for darwin/amd64, darwin/arm64, linux/amd64, linux/arm64, and windows/amd64. Windows ARM64 falls back to go install until ARM64 binaries are published. Installing klim is the first step toward turning a local machine into a productivity booster for dev tools.

curl -fsSL https://raw.githubusercontent.com/nassiharel/klim/main/install.sh | bash

The installer automatically detects your OS and architecture, downloads the latest release, verifies the SHA256 checksum, and installs to /usr/local/bin.

Options:

# Install a specific version
curl -fsSL ... | bash -s -- --version v1.0.0

# Install without sudo (to ~/.local/bin)
curl -fsSL ... | bash -s -- --no-sudo --install-dir ~/.local/bin

irm https://raw.githubusercontent.com/nassiharel/klim/main/install.ps1 | iex

The installer detects your architecture, downloads the latest release, verifies the checksum, and adds klim to your PATH.

Options:

# Install a specific version
$env:CLIM_VERSION = "v1.0.0"
irm https://raw.githubusercontent.com/nassiharel/klim/main/install.ps1 | iex

# Custom install directory
$env:CLIM_INSTALL_DIR = "C:\tools\klim"
irm https://raw.githubusercontent.com/nassiharel/klim/main/install.ps1 | iex

Homebrew (macOS / Linux)

brew install nassiharel/tap/klim

winget (Windows)

winget install nassiharel.klim

Each klim release auto-submits a PR to microsoft/winget-pkgs, so the latest version is published system-wide through winget.

Scoop (Windows)

scoop bucket add nassiharel https://github.com/nassiharel/scoop-bucket
scoop install klim

The Scoop manifest is published to nassiharel/scoop-bucket on every release and points at the official klim_<version>_windows_amd64.zip asset from the corresponding GitHub Release, so version and contents are guaranteed to match. Scoop itself runs on Windows ARM64, but klim only ships a windows/amd64 archive today (the GoReleaser build matrix explicitly skips windows/arm64). On Windows ARM64, fall back to go install (see below) until ARM64 binaries are published.

Go Install

If you have Go 1.25+ installed:

go install github.com/nassiharel/klim/cmd/klim@latest

Download Binary

Download pre-built binaries from the GitHub Releases page.

Available platforms:

macOS (amd64, arm64)
Linux (amd64, arm64)
Windows (amd64) — Windows ARM64 is not yet published; use go install

Linux Packages

# Debian / Ubuntu (amd64 or arm64)
sudo dpkg -i klim_<version>_linux_<arch>.deb

# RPM-based (Fedora, CentOS, RHEL — amd64 or arm64)
sudo rpm -i klim_<version>_linux_<arch>.rpm

Build from Source

git clone https://github.com/nassiharel/klim.git
cd klim
make build
./bin/klim

Verify Installation

After installing, verify klim is working:

klim version

Next Steps

Head to the Quick Start guide to map your current toolchain, create environment contracts, and automate repeatable setup.