pkg-upgrade 1.1.0

A cross-platform TUI that upgrades every package manager on your system

pkg-upgrade

A beautiful Textual-based TUI that upgrades every macOS package manager you have installed — Homebrew formulas & casks, pip, npm, gem, and macOS system updates — with smart parallel execution, per-manager confirmations, and a detailed dashboard.

Features

• 🍺 Homebrew formulas + 🍻 casks
• 🐍 pip3
• 📦 npm (global)
• 💎 gem
• 🍎 softwareupdate
• Smart parallel execution (brew → cask → pip sequential; npm/gem/system parallel)
• Per-manager confirmation with preview, or --yes to skip prompts
• Timestamped log file + native macOS notification on completion
• --skip / --only / --dry-run / --list

Installation

One-line (recommended)

curl -fsSL https://raw.githubusercontent.com/liskeee/pkg-upgrade/main/install.sh | bash

Pin a specific version:

curl -fsSL https://raw.githubusercontent.com/liskeee/pkg-upgrade/main/install.sh \
    | MAC_UPGRADE_REF=v0.1.0 bash

The installer uses pipx when available and falls back to a self-managed venv at ~/.local/share/pkg-upgrade/. Requires Python 3.12+ and macOS.

Homebrew

brew tap liskeee/pkg-upgrade https://github.com/liskeee/pkg-upgrade
brew install pkg-upgrade

pipx

pipx install git+https://github.com/liskeee/pkg-upgrade

From source

git clone https://github.com/liskeee/pkg-upgrade
cd pkg-upgrade
pipx install .

Uninstall

# installed via pipx (the default path):
pipx uninstall pkg-upgrade

# installed via the venv fallback:
rm -rf ~/.local/share/pkg-upgrade ~/.local/bin/pkg-upgrade

Usage

pkg-upgrade                      # interactive dashboard
pkg-upgrade --yes                # upgrade everything without prompts
pkg-upgrade --only brew,npm      # only specific managers
pkg-upgrade --skip system        # skip macOS system updates
pkg-upgrade --dry-run            # preview only
pkg-upgrade --list               # detect installed managers and exit

License

MIT