klim tool upgrade

klim tool upgrade brings installed tools to the latest version reported by their package manager. Flag set matches klim tool install; source precedence differs slightly so the upgrade runs through the package manager the tool was actually installed from (see below).

Source precedence

For an installed tool, klim picks the package manager in this order:

--source <pm> flag (per invocation), if it maps to a package id for this tool
defaults.preferred_source in config.yaml, if it maps to a package id
The tool’s installed package manager (detected during the PATH scan)
BestInstallSource() — last-ditch OS-priority fallback

That ordering avoids the surprise of running winget upgrade jq on a jq that was installed via scoop. The same precedence applies to klim tool remove.

Usage

klim tool upgrade [tool...] [flags]

At least one positional tool name or --pack is required.

Behavior per target

State	Outcome
Installed and update available	upgrade
Installed and already at latest	skipped (`up_to_date`)
Not installed	skipped (`not_installed`) — use `klim tool install`
Not in catalog	reported, skipped

klim tool upgrade --pack <name> is therefore safe to run on machines that have only some of the pack’s tools — missing tools are skipped, no auto-install happens.

Flags

Same as klim tool install: --source, --pack (repeatable), --dry-run, --yes/-y, --refresh, --output.

Examples

# Upgrade a single tool
klim tool upgrade jq

# Upgrade everything in a pack
klim tool upgrade --pack go-developer

# Force a specific manager
klim tool upgrade jq --source brew --yes

# Dry-run a multi-pack upgrade
klim tool upgrade --pack rust-dev --pack web-dev --dry-run

# JSON for scripts
klim tool upgrade --pack go-developer --output json --yes

Exit codes

Same as klim tool install: 0 OK, 1 runtime error, 2 usage error, 3 partial failure.