upkg

Check, search, upgrade, and clean detected managers

upkg search ripgrep

upkg [command] [args] [flags]

Availability: Available when at least one supported package manager is installed
Dependencies: a supported package manager

Some subcommands change stored data or packages. Check the selected operation before running.

Adapts to terminal

Examples appear only where they add useful detail.

outdated: Show outdated packages across detected managersAlso known as: check, list
Example
upkg
check for outdated packages
upkg --only brew,npm
check selected managers
search <query>: Search package names across detected managers
Example
upkg search ripgrep
compare package search matches
upkg search ripgrep --only=apt,nix
upgrade: Run upgrades across selected managersAlso known as: up, update
Example
upkg upgrade --dry-run --only npm
preview selected upgrades
upkg upgrade --sudo --only apt
run a privileged backend
plan: Inventory available updates without resolving transactions
Example
upkg plan
inventory updates
clean: Remove unused packages and manager-owned caches
Example
upkg clean --dry-run --only brew,npm
preview manager-owned cleanup
upkg clean --sudo --only apt
remove unused APT data
managers: Show detected managers and alternates
Example
upkg managers --only npm,flatpak
inspect selected order
help: Show this help text

Features and descriptions, with matching examples for upkg
Usage	Description	Example
`outdated`	Show outdated packages across detected managersAlso known as: check, list	`upkg` check for outdated packages `upkg --only brew,npm` check selected managers
`search <query>`	Search package names across detected managers	`upkg search ripgrep` compare package search matches `upkg search ripgrep --only=apt,nix`
`upgrade`	Run upgrades across selected managersAlso known as: up, update	`upkg upgrade --dry-run --only npm` preview selected upgrades `upkg upgrade --sudo --only apt` run a privileged backend
`plan`	Inventory available updates without resolving transactions	`upkg plan` inventory updates
`clean`	Remove unused packages and manager-owned caches	`upkg clean --dry-run --only brew,npm` preview manager-owned cleanup `upkg clean --sudo --only apt` remove unused APT data
`managers`	Show detected managers and alternates	`upkg managers --only npm,flatpak` inspect selected order
`help`	Show this help text	No example documented

Manager: apt, dnf, pacman, paru, brew, flatpak, nix, npm
upkg with no command defaults to outdated
search prints one compact table with a manager column
plan and upgrade --dry-run inventory updates without installing packages
queries and previews may contact the network and write caches
clean mutates manager state; clean --dry-run previews without removing packages or caches
summaries show elapsed time per manager and in total, including prompt waits
upgrades never inject sudo automatically
paru upgrades require explicit --sudo opt-in but still run unprefixed
brew upgrades run unprefixed and stay in Homebrew user space
npm upgrades stay user-space only; upkg will not recommend sudo npm

Usage reference