freshenup 3.1.0

Pick outdated Homebrew and Mac App Store items to upgrade or uninstall

freshenup

Pick outdated Homebrew formulae and casks — and, optionally, outdated Mac App Store apps and mise tools — from an fzf menu, then upgrade or uninstall them.

A formula node is a top-level (leaf) formula that is outdated itself or has outdated dependencies beneath it; a cask or App Store app is a standalone node. Everything starts selected. Keys are shown in the fzf header. App Store rows show a slugified name; the numeric id drives the action via mas (which needs root, so a sudo prompt appears only when an App Store row is selected). mise tools (global config only, via mise outdated -C /) are standalone nodes that upgrade within their configured version range; they can't be uninstalled from here.

Install

uv tool install freshenup   # install, or `uvx freshenup` to run without installing
uv tool upgrade freshenup   # update

Usage

freshenup          # scan and pick
freshenup -u       # force `brew update` first (brew otherwise auto-refreshes at most once/24h)

• enter — upgrade the selected nodes
• ctrl-x — uninstall the highlighted node (confirmed)
• tab — toggle selection
• ctrl-t — invert selection

Dependencies

• fzf 0.53+ — the interactive picker (brew install fzf)
• Homebrew
• Python 3.14+ and pydantic (installed automatically with the package)
• Optional: mas for Mac App Store support (detected at runtime)
• Optional: mise for dev-tool/runtime updates (detected at runtime; global config only)

Development

Managed with uv; lint/format with Ruff, type-checked with pyright (strict).

uv sync              # create the venv and install deps
uv run pytest        # run tests
uv run ruff check    # lint
uv run ruff format   # format
uv run pyright       # type-check (strict)

License

MIT