---

---

Why Bold Brew?

Homebrew is powerful, but managing hundreds of packages from the command line is tedious. Bold Brew gives you a visual interface to browse, search, and manage everything — formulae, casks, Flatpak apps, and Mac App Store apps — from a single keyboard-driven TUI.

• See everything at a glance — installed status, outdated packages, download popularity
• Curate with Brewfiles — load local or remote Brewfiles for themed package collections
• Stay secure — scan packages for CVEs with one keystroke
• Works with Homebrew 4, 5, and 6 — leverages the latest features automatically

---

---

Features

Package Management

Manage Homebrew formulae, casks, Flatpak, and Mac App Store apps from one interface. Install, update, and remove packages with confirmation dialogs and real-time streaming output.

Discovery and Filtering

Fast search across 15,000+ packages. Filter by installed, outdated, leaves, casks, or formulae. Sort by download popularity or name. See type indicators [F] [C] [M] at a glance.

Brewfile Workflows

Load Brewfiles from local paths or remote URLs. Batch install/remove entire collections. Export your installed packages to a ~/Brewfile with one keystroke. Supports brew, cask, tap, mas, and flatpak entries.

Security and Health

On-demand vulnerability scanning via brew vulns (press v). Deprecated and disabled package warnings with replacement suggestions. Full Homebrew 6.0 compatibility including tap trust and ask mode.

---

Installation

Quick Install (Recommended)

Install Homebrew + Bold Brew with a single command:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Valkyrie00/bold-brew/main/install.sh)"

Via Homebrew

brew install bbrew

Manual Download

Grab the latest binary from the releases page.

---

Quick Start

# Browse all packages
bbrew

# Load a Brewfile (local or remote)
bbrew -f ~/Brewfile
bbrew -f https://raw.githubusercontent.com/user/repo/main/Brewfile

See the examples/ directory for ready-to-use Brewfiles (dev tools, AI tools, K8s, etc.).

---

Keyboard Shortcuts

Navigation

Key	Action
/	Search packages
↑/↓ or j/k	Navigate list
Esc	Back to table
?	Help screen
q	Quit

Filters and Sorting

Key	Action
f	Toggle installed
o	Toggle outdated
l	Toggle leaves
c	Toggle casks
F	Toggle formulae
s	Cycle sort (None → Downloads → Name)

Package Operations

Key	Action
i	Install selected
u	Update selected
r	Remove selected
v	Vulnerability scan
e	Export to ~/Brewfile
Ctrl+U	Update all outdated

Brewfile Mode

Key	Action
Ctrl+A	Install all from Brewfile
Ctrl+R	Remove all from Brewfile

---

Screenshots

---

Compatibility

---

Security

• brew vulns — On-demand CVE scanning for installed packages (press v in the TUI)
• govulncheck — Go dependency vulnerability scanning in CI
• gosec — Static security analysis in CI
• Gated releases — Tests + lint must pass before any release is published

Found a vulnerability? Report it via GitHub Security Advisories.

---

Contributing

We welcome contributions! See CONTRIBUTING.md for setup instructions, project structure, and guidelines.

Quick start:

git clone https://github.com/Valkyrie00/bold-brew.git && cd bold-brew
make build-local && make test quality-local

Contributors

License

MIT — see LICENSE for details.

---