brewery 0.3.0

A fast, friendly TUI for Homebrew
brewery-0.3.0 is not a library.

Brewery 🍺

A blazingly fast terminal UI for Homebrew

Browse, search, and manage your Homebrew packages with ease

Crates.io Downloads License: MIT Rust Brewed Fresh Blazingly Fast

Features

  • 📦 Package Browser — Browse installed leaves with instant search filtering
  • 🔍 Advanced Search — Search all available Homebrew packages
  • 📊 Rich Details — View descriptions, homepage, versions, dependencies, and reverse dependencies
  • 📈 Status Panel — Track activity, diagnostics issues, outdated packages, and brew update recency
  • 📏 Size Analytics — Leaderboard of installed packages by disk usage
  • ⚡ Quick Actions — Install, uninstall, upgrade, upgrade all outdated, cleanup, autoremove, and export Brewfiles
  • 🎯 Outdated Workflow — Toggle outdated-only leaves filter and batch-upgrade outdated packages
  • 🎨 Adaptive Theming — Auto-detects system theme with manual override (light/dark)
  • 🖥️ Pure Terminal — No browser required, works entirely in your terminal

Installation

cargo install brewery

Requirements

  • Homebrew installed and available as brew
  • Rust toolchain (edition 2024)
  • Terminal with True Color support

Font

Nerd Font is optional. Use ASCII mode with BREWERY_ASCII=1 or press Alt+i in-app.

Keyboard Shortcuts

Navigation

Key Action
j/k or ↑/↓ Move selection
Tab/Shift+Tab Cycle focus between panels

Search

Key Action
/ Filter installed leaves (live filter)
f Search all packages
Enter Confirm search / Exit filter mode
Esc Cancel / Clear filter

Package Management

Key Action
i Install package (press twice to confirm)
u Uninstall package (press twice to confirm)
Shift+U Upgrade selected leaf, or upgrade all outdated in Status -> Outdated (press twice to confirm)
Enter Load package details
d Load dependencies and reverse dependencies

Maintenance

Key Action
r Refresh package list
s Load package sizes
h Run status check
o Toggle outdated-only leaves filter
c Cleanup old versions
a Autoremove unused dependencies
b Export Brewfile (bundle dump)

View

Key Action
v Toggle details/results view
t Toggle theme (auto/light/dark)
Alt+i Toggle Nerd Font / ASCII icons
? Show help
q Quit

Changelog

See CHANGELOG.md for detailed release notes and version history.