Skip to content

About

Homebrew upgrade manager — upgrade and restart affected apps

Topics

Resources

Stars

4 stars

Watchers

0 watching

Forks

Repository files navigation

brew-bouncer

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

Features

  • 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, and brew 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

Install

brew tap jdillon/planet57
brew install brew-bouncer

Usage

# 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 --yes

Configuration

Optional config lives at ~/.config/brew-bouncer/config.yaml.

ignore:
  - some-cask

promptDefaults:
  upgrade: yes
  restartPolicy: yes
  quarantinePolicy: yes

promptDefaults controls the default choice when you press Enter at the main upgrade prompts:

  • upgrade: yes, no, or select
  • restartPolicy: yes, ask, or no
  • quarantinePolicy: yes, ask, or no

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.

Building from source

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 Bun

License

Apache 2.0

About

Homebrew upgrade manager — upgrade and restart affected apps

Topics

Resources

Stars

4 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages