upkg

Check, search, upgrade, and clean detected managers

Package Updates

upkg

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: Preview available upgrades without changing packages
Example
upkg plan
preview upgrades
clean: Remove unused packages and stale 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`	Preview available upgrades without changing packages	`upkg plan` preview upgrades
`clean`	Remove unused packages and stale 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

Flag: --only <list> Comma-separated manager IDs to include
Flag: --skip <list> Comma-separated manager IDs to exclude
Flag: --sudo Authorize privileged upgrade and cleanup backends
Flag: --dry-run Preview upgrades or cleanup without changing packages
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 use the read-only outdated checks
clean is mutating; use clean --dry-run for a read-only preview
cleanup uses conservative manager commands and never deletes app data or user config directly
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