Homebrew upgrade manager for macOS. Updates and upgrades your packages, detects which running apps were affected, and walks you through restarting them. Replaces the common post-upgrade reboot with targeted restarts.
- Upgrade preview — shows what will be upgraded with version diffs, which apps are running, and which were skipped
- Interactive selection — confirm all, pick individual packages, or select with a checkbox UI
- Restart detection — finds running apps affected by upgrades using
osascript,
ps,pkgutil, andbrew services - Targeted restarts — quit and reopen GUI apps, restart brew services, or show manual instructions for CLI tools
- Quarantine management — preserves macOS quarantine approvals across upgrades so you don't re-approve trusted apps
- Restart policy — choose upfront: auto-restart all, ask per-app, or skip
brew tap jdillon/planet57
brew install brew-bouncer# Show outdated packages and what's running
brew bouncer status
# Upgrade everything with interactive prompts
brew bouncer upgrade
# Upgrade specific packages
brew bouncer upgrade firefox slack
# Approve upgrades, restarts, and quarantine removal without prompting
brew bouncer upgrade --yesOptional config lives at ~/.config/brew-bouncer/config.yaml.
ignore:
- some-cask
promptDefaults:
upgrade: yes
restartPolicy: yes
quarantinePolicy: yespromptDefaults controls the default choice when you press Enter at the main
upgrade prompts:
upgrade:yes,no, orselectrestartPolicy:yes,ask, ornoquarantinePolicy:yes,ask, orno
If omitted, the built-in defaults remain yes for upgrade confirmation and
no for restart/quarantine policy prompts.
--yes overrides these defaults and answers yes to every upgrade, restart,
and quarantine-removal prompt.
The upgrade preview includes Homebrew's planned dependency installs and
dependent upgrades in the same table. Changing the package selection refreshes
the preview for approval. Execution uses --no-ask to avoid repeated
Homebrew upgrade confirmations; installer and privilege prompts remain interactive.
Requires Moon. The repository pins Bun; setup installs that version and dependencies.
moon run root:setup
moon run root:check
moon run root:build-verify # native macOS binary at dist/brew-bouncer
moon run root:cli -- --help # run source CLI with pinned BunApache 2.0
