Bold Brew is the official Terminal UI for managing Homebrew in Project Bluefin and Aurora, next-generation Linux desktops that serve tens of thousands of users worldwide.
"This application features full package management for homebrew in a nice nerdy interface"
— Bluefin Documentation
- 🚀 Modern TUI Interface - Clean and responsive terminal user interface
- 📦 Complete Package Management - Manage both Homebrew formulae and casks
- 📋 Brewfile Mode - Curated package collections from local or remote Brewfiles
- 🔍 Advanced Search - Fast fuzzy search across all packages
- 🎯 Smart Filters - Filter by installed, outdated, leaves, or casks
- 📊 Analytics Integration - See popular packages based on 90-day download stats
- 🔄 Real-time Updates - Live feedback during package operations
- ⌨️ Keyboard Shortcuts - Intuitive keybindings for all operations
- 🎨 Type Indicators - Visual distinction between formulae [F] and casks [C]
- 🗂️ XDG Compliance - Follows XDG Base Directory Specification for cache storage
- 🔒 Security Scanning - Automated vulnerability and security checks
Install Homebrew + Bold Brew with a single command:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Valkyrie00/bold-brew/main/install.sh)"If you already have Homebrew installed:
brew install Valkyrie00/homebrew-bbrew/bbrewDownload the latest version from the releases page
Launch the application to browse all Homebrew packages:
bbrewLaunch with a curated Brewfile to show only specific packages:
# Local Brewfile
bbrew -f /path/to/Brewfile
# Remote Brewfile (HTTPS)
bbrew -f https://raw.githubusercontent.com/user/repo/main/BrewfileIn Brewfile mode, you can:
- View only packages from the Brewfile
- Pick and choose what to install individually
- Use all standard features (search, filters, etc.)
- Load Brewfiles directly from URLs (great for sharing configurations!)
Perfect for creating themed collections like IDE choosers, dev tools, AI tools, K8s tools, etc.
See the examples/ directory for ready-to-use Brewfiles.
bbrew [options]
Options:
-f <path|url> Path or URL to Brewfile (local file or HTTPS URL)
-v, --version Show version information
-h, --help Show help message/- Search packages↑/↓orj/k- Navigate package listEnter- View package detailsEsc- Clear search / Back to table?- Show help screen
f- Filter installed packageso- Filter outdated packagesl- Filter leaves (explicitly installed)c- Filter casks only
i- Install selected packageu- Update selected packager- Remove selected packageCtrl+U- Update all outdated packages
Ctrl+A- Install all packages from BrewfileCtrl+R- Remove all packages from Brewfile
q- Quit application
Filtered view showing installed packages
Fuzzy search in action
Brewfile mode with curated package selection
| Platform | Support | Notes |
|---|---|---|
| 🍎 macOS | ✅ Full | Native Homebrew support |
| 🐧 Linux | ✅ Full | Linuxbrew/Homebrew support |
Security is a priority for Bold Brew. We use:
- govulncheck - Go vulnerability database scanning
- gosec - Static security analysis
- Automated CI/CD - Security checks on every PR and push
Found a security issue? Please report it privately via GitHub Security Advisories.
- Go 1.25+
- Homebrew (for testing)
- Podman (optional, for containerized builds)
# Clone the repository
git clone https://github.com/Valkyrie00/bold-brew.git
cd bold-brew
# Build locally
make build-local
# Run tests
make test
# Run linter
make quality-local
# Run security scans
make securitybold-brew/
├── cmd/bbrew/ # Main application entry point
├── internal/
│ ├── models/ # Data models (Formula, Cask, Package)
│ ├── services/ # Business logic (Brew, App, Search, Input, Brewfile)
│ └── ui/ # TUI components and layout
├── .github/workflows/ # CI/CD pipelines
└── Makefile # Build automation
Contributions are welcome! Please:
- 🍴 Fork the project
- 🔨 Create your feature branch (
git checkout -b feat/amazing-feature) - 📝 Commit your changes using Conventional Commits
- 🧪 Run tests and linters (
make test quality-local) - 🚀 Push to the branch (
git push origin feat/amazing-feature) - 📬 Open a Pull Request
Bold Brew exists thanks to the efforts of these wonderful people
This project is licensed under the MIT License - see the LICENSE file for details.
- 🌟 Star the project
- 🐛 Report a bug
- 💡 Request a feature
- 📣 Share the project with your friends