GitHub

Install

Get the kdef CLI and language server on your machine.

Latest release: v0.7.7

kdef ships as a single self-contained binary. Zero runtime dependencies.

Go install

go install github.com/gsid-nl/kdef/cmd/kdef@latest
go install github.com/gsid-nl/kdef/cmd/kdef-lsp@latest

This is the fastest way if you already have Go (1.26 or later) installed. A go install build reports its version as dev; the release binaries below carry the release number.

Prebuilt binaries

Every release has kdef and kdef-lsp binaries for Linux and macOS (amd64 and arm64) and for Windows (amd64).

# Example: Linux amd64
curl -L -o kdef https://github.com/gsid-nl/kdef/releases/latest/download/kdef-linux-amd64
chmod +x kdef
sudo mv kdef /usr/local/bin/

kdef version

The language server downloads the same way, as kdef-lsp-linux-amd64, kdef-lsp-darwin-arm64 and so on.

Linux packages

Native .deb, .rpm, and .apk packages (amd64 and arm64) are also published on each release. They install kdef and its bash completion; get kdef-lsp from the binaries above. The package file names carry the version number:

KDEF_VERSION=v0.7.7
BASE=https://github.com/gsid-nl/kdef/releases/download/$KDEF_VERSION
V=${KDEF_VERSION#v}

# Debian / Ubuntu (arm64: kdef_${V}_arm64.deb)
curl -LO $BASE/kdef_${V}_amd64.deb
sudo dpkg -i kdef_${V}_amd64.deb

# Fedora / RHEL (aarch64: kdef-${V}-1.aarch64.rpm)
sudo rpm -i $BASE/kdef-${V}-1.x86_64.rpm

# Alpine (aarch64: kdef_${V}_aarch64.apk)
curl -LO $BASE/kdef_${V}_x86_64.apk
sudo apk add --allow-untrusted kdef_${V}_x86_64.apk

Build from source

git clone https://github.com/gsid-nl/kdef.git
cd kdef
make build          # produces ./kdef and ./kdef-lsp
make build-all      # cross-compile into dist/: linux and macOS (amd64, arm64), windows (amd64)
make package        # .deb, .rpm, .apk (requires nfpm)

Verify

kdef version
# kdef X.Y.Z (commit: abcdef1, built: 2026-01-01T12:00:00Z)

Next

  • Already have a cluster? Jump to the Quickstart: it imports a live namespace and deploys it back in five minutes.
  • Starting from nothing? The API-with-sidecar guide builds a realistic deployment from scratch.
  • Using VS Code or a JetBrains IDE? Set up the language server for live diagnostics.