https://github.com/jdillon/brew-bouncer
Homebrew upgrade manager — upgrade and restart affected apps
https://github.com/jdillon/brew-bouncer
bun cli homebrew macos typescript
Last synced: 3 months ago
JSON representation
Homebrew upgrade manager — upgrade and restart affected apps
- Host: GitHub
- URL: https://github.com/jdillon/brew-bouncer
- Owner: jdillon
- License: apache-2.0
- Created: 2026-02-15T01:45:41.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-03-28T07:43:41.000Z (3 months ago)
- Last Synced: 2026-03-28T12:34:29.517Z (3 months ago)
- Topics: bun, cli, homebrew, macos, typescript
- Language: TypeScript
- Size: 144 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
README
# 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.
## 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
```bash
brew tap jdillon/planet57
brew install brew-bouncer
```
## Usage
```bash
# 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
# Skip all confirmations
brew bouncer upgrade --yes
```
## Building from source
Requires [Bun](https://bun.sh).
```bash
bun install
bun run typecheck
bun run build # native binary at dist/brew-bouncer
bun run dev # run from source
```
## License
Apache 2.0