Brew Potato

Project Overview

Brew Potato is a full-screen terminal UI for Homebrew built with Go and Bubble Tea. It focuses on the packages you explicitly installed, filtering out dependencies so you can browse, inspect install dates, and uninstall without leaving the UI.

Why

brew list mixes your packages with all their dependencies. Brew Potato keeps the view clean by showing only user-installed formulae and handling missing brew gracefully instead of crashing.

Key Features

• Filtered list of user-installed Homebrew formulae with install dates
• Interactive uninstall with async spinner and in-place row updates
• Styled header/footer and rounded table borders via Lip Gloss
• Clear messaging if Homebrew is not available

Built With

• Bubble Tea (TUI framework)
• Bubbles (table + spinner components)
• Lip Gloss (styling and layout)

Requirements

• Go 1.21+
• Homebrew installed and on PATH

Run

go mod tidy
go run .

Build

go build -o brew-potato .
./brew-potato

Keybindings

Next Steps

Integrate GoReleaser to publish Brew Potato as a Homebrew formula so users can install it with brew install.

Links

• GitHub: https://github.com/mrSamDev/brew-potato