Skip to content
klim

Environment Diff

Use klim diff to compare your installed tools against a manifest file or share token. It turns “works on my machine” into a concrete environment delta you can fix, review, or enforce in CI.

Comparing Against a Manifest

Section titled “Comparing Against a Manifest”

Export your tools on one machine, then diff on another:

Terminal window
# Machine A: export
klim export > alice-tools.yaml


# Machine B: compare
klim diff alice-tools.yaml

Comparing Against a Share Token

Section titled “Comparing Against a Share Token”

Share tokens are compact strings you can paste in Slack or Teams:

Terminal window
# Generate a token
klim share
# → klim:v1:H4sIAAAA...


# Compare on another machine
klim diff "klim:v1:H4sIAAAA..."

Reading the Output

Section titled “Reading the Output”
TOOL      LOCAL                  REMOTE           STATUS
----      -----                  ------           ------
git       2.53.0 (winget)        2.54.0 (winget)  ≠ differs
gh        2.74.2 (winget)        2.74.2 (winget)  ✓ match
kubectl   —                      1.28.0 (brew)    → remote only
node      24.14.1 (winget)       —                ← local only
StatusMeaning
✓ matchSame tool, same version
≠ differsSame tool, different versions
← local onlyYou have it, they don’t
→ remote onlyThey have it, you don’t

CI Usage

Section titled “CI Usage”

klim diff returns exit code 1 when differences are found:

- name: Check environment matches baseline
  run: klim diff baseline-tools.yaml

See Also

Section titled “See Also”