winget install --id=nassiharel.klim -e klim is a productivity booster for dev tools: a deterministic, cross-platform layer for discovering, standardising, securing, and automating the tools every project depends on. It keeps native package managers in charge of installation while giving humans, teams, CI, and AI agents the same portable environment contracts and predictable operations.
Reignite Dev Experience.
Klim is a productivity booster for dev tools: a deterministic, cross-platform layer for discovering, standardizing, securing, and automating the tools every project depends on. It keeps native package managers in charge of installation while giving humans, teams, CI, and AI agents the same portable environment contracts and predictable operations.
# Recommended — installer script
curl -fsSL https://raw.githubusercontent.com/nassiharel/klim/main/install.sh | bash
# Homebrew tap
brew install nassiharel/tap/klim
# Recommended — installer script
irm https://raw.githubusercontent.com/nassiharel/klim/main/install.ps1 | iex
# winget
winget install nassiharel.klim
# Scoop bucket
scoop bucket add nassiharel https://github.com/nassiharel/scoop-bucket
scoop install klim
go install github.com/nassiharel/klim/cmd/klim@latest
klim version
Other install options (deb / rpm / direct binary)
# Replace with amd64 or arm64
curl -LO https://github.com/nassiharel/klim/releases/latest/download/klim__linux_.deb
sudo dpkg -i klim__linux_.deb
# Replace with amd64 or arm64
curl -LO https://github.com/nassiharel/klim/releases/latest/download/klim__linux_.rpm
sudo rpm -i klim__linux_.rpm
Pre-built archives for every platform are attached to each GitHub Release:
klim__darwin_amd64.tar.gz / klim__darwin_arm64.tar.gzklim__linux_amd64.tar.gz / klim__linux_arm64.tar.gzklim__windows_amd64.zipEach archive ships with a CycloneDX SBOM (*.sbom.json) and an entry in the release's checksums.txt. Verify a download with:
sha256sum klim__.tar.gz
# compare against checksums.txt
# install.sh — bash flag
curl -fsSL https://raw.githubusercontent.com/nassiharel/klim/main/install.sh | bash -s -- --version v0.1.2
# install.ps1 — env var
$env:CLIM_VERSION = "v0.1.2"
irm https://raw.githubusercontent.com/nassiharel/klim/main/install.ps1 | iex
# go install — version suffix
go install github.com/nassiharel/klim/cmd/klim@v0.1.2
# brew / winget / scoop — pin via the package manager itself
brew install nassiharel/tap/klim@0.1.2
winget install nassiharel.klim --version 0.1.2
scoop install klim@0.1.2
Or download the matching archive from the tagged release page directly.
Launch the interactive TUI:
klim
Or use deterministic commands from scripts, CI, or agents:
klim check --output json
klim diff teammate.yaml
klim security audit --sbom
klim install --pack go-developer
Klim scans your PATH and native package managers to show installed developer tools, versions, install sources, binary paths, GitHub metadata, project references, pack membership, and update status.
Drop a .klim.yaml in a repo to define required and optional tools with version constraints. klim check validates every developer's environment locally or in CI, and klim init can generate the contract from project files such as package.json, go.mod, Dockerfiles, CI workflows, Helm charts, Terraform, Bicep, and more.
Export, import, share, diff, and capture environment snapshots. Klim maps tools to the best available package manager on each OS, so a known-good setup can move between macOS, Linux, Windows, containers, and teammates.
Klim delegates installs and upgrades to the package managers you already trust: winget, Homebrew, apt, Chocolatey, Scoop, snap, and npm. It adds selection, planning, JSON output, exit codes, dry runs, packs, and cross-manager visibility without replacing those managers.
Run health checks, security audits, license inventory, vulnerability scans, and CycloneDX SBOM generation across your toolchain. Klim flags PATH problems, unmanaged installs, archived upstreams, stale repositories, missing versions, and known CVEs/GHSAs.
AI agents are good at translating intent. Klim is the stable local primitive they should call for environment operations. Instead of asking an agent to improvise package-manager commands, let it run klim check, klim install, klim diff, or klim security audit --output json and parse predictable results.
<strong>Installed</strong>Every tool, every version, every install source
<strong>Dashboard</strong>Score, coverage, GitHub highlights, package-manager mix
<img src="assets/examples/klim-installed-tui.png" />
<img src="assets/examples/klim-dashboard-tui.png" />
<strong>Marketplace</strong>110+ curated tools with category, stars, and policy state
<strong>Curated packs</strong>Bundle status across Cloud Essentials, Kubernetes Starter, Go Developer, …
<img src="assets/examples/klim-marketplace-tui.png" />
<img src="assets/examples/klim-marketplace-packs-tui.png" />
<strong>For You</strong>Personalised recommendations ranked by overlap with your installed set
<strong>Project scan</strong>Auto-detect required tools from go.mod, package.json, .github/
<img src="assets/examples/klim-marketplace-for-you-tui.png" />
<img src="assets/examples/klim-project-tui.png" />
<strong>Compliance</strong>Disallowed sources, blocked tools, license violations against your active policy
<strong>Local browser</strong>klim browser — same data and actions as the TUI in your default browser
<img src="assets/examples/klim-security-compliance-tui.png" />
<img src="assets/examples/klim-local-browser-view.png" />
> Nine TUI tabs and an optional local web view. Same data, same actions, same JSON — whichever surface you prefer.
| Workflow | Commands |
|---|---|
| Map this machine | klim, klim list, klim info kubectl |
| Standardize a project | klim init, klim check, klim generate github-action |
| Reproduce an environment | klim export, klim import, klim env show, klim env apply |
| Compare machines | klim diff baseline.yaml, klim trail capture, klim trail diff |
| Audit and score | klim health, klim health path, klim security audit, klim score, klim security vuln |
| Preview and apply | klim plan, klim apply, klim checkpoint , klim rollback |
| Automate installs | klim install jq, klim upgrade --pack go-developer, klim remove jq, klim watch |
| Agent-safe execution | klim check --output json, klim install --dry-run --output json |
klim plan) with confidence scoring, auto-checkpointed execution (klim apply) with shell-resolution + binary-validation + PATH-consistency + manager-integrity postcheck, and named snapshot management (klim checkpoint, klim rollback)..klim.yaml contracts for local checks, CI, generated workflows, Dockerfiles, and devcontainers.klim env captures tools, favorites, custom packs, package managers, Klim version, OS, and security state into a privacy-safe token.klim trail captures content-addressed snapshots that can be labeled, diffed, pruned, and compared over time..klim.yaml checks when you enter a project.klim proxy creates lightweight shims that install missing tools on first use through the best available package manager.klim why, and klim try for temporary installs.Agents can translate fuzzy intent into commands, but environment operations need determinism, auditability, local privacy, and stable artifacts. Klim and agents solve different parts of the problem.
klim install --pack go-developer --output json exits the same way every time. A prompt does not.curl | bash suggestions from model context..klim.yaml and policy files are reviewable contracts. Prompt instructions are not auditable controls.The honest framing: agents handle judgment calls; Klim handles operations that must be the same every time.
Klim is written in Go with a Bubble Tea TUI and Cobra CLI. The runtime flow is:
ToolService
-> ToolCatalog fetch/cache marketplace.yaml from GitHub
-> ToolFinder scan PATH and detect install sources
-> VersionResolver query native package managers for installed/latest versions
Version data comes from native package managers, not a private registry:
| Package manager | Platforms | Used for |
|---|---|---|
| winget | Windows | Installed and latest versions |
| Chocolatey | Windows | Installed and latest versions |
| Homebrew | macOS, Linux | Installed and latest versions |
| apt / dpkg | Debian/Ubuntu | Installed and latest versions |
| snap | Linux | Installed and latest versions |
| npm | All | Installed and latest versions |
The marketplace is fetched from https://raw.githubusercontent.com/nassiharel/klim/marketplace/marketplace.yaml and cached locally for offline use.
Klim stores user data under ~/.klim/ (same path on macOS, Linux, and Windows). The marketplace cache lives at ~/.klim/marketplace/marketplace-cache.yaml.
Use:
klim config path
klim config edit
| Problem | Solution |
|---|---|
klim: command not found | Ensure the install directory is in PATH. Use which klim on macOS/Linux or where klim on Windows. |
| Tool not detected | Verify the binary is in PATH, then run klim and press r or use --refresh on CLI commands. |
| Permission denied on upgrade | The native package manager may need elevated privileges. Use sudo or an Administrator shell where appropriate. |
| Stale version info | Run klim security health, use --refresh, or clear the scan cache. |
| Self-update fails | Download the latest archive from Releases and replace the binary manually. |
Contributions are welcome. See AGENTS.md for architecture, conventions, and development commands.
MIT