@agpenton/brewui
v0.1.2
Published
Terminal UI for Brewfile inventory and package operations
Readme
brewui
A keyboard-driven TUI for Homebrew bundle inventory and package maintenance.
Layout:
- Left pane: package list
- Top-right pane: local package details (from Brewfile parsing/state)
- Bottom-right pane: source info output (
brew info/mas info)
Requirements
- macOS
- Homebrew installed
- Node.js 20+
- pnpm
Quick start
pnpm install
pnpm devGhostty note:
brewuiauto-falls back toTERM=xterm-256colorwhen it detects Ghostty to avoid ablessedterminfo parsing crash.- Manual fallback (if needed):
TERM=xterm-256color pnpm dev
Scripts
pnpm devrun TUI in developmentpnpm buildcompile TypeScriptpnpm startrun compiled apppnpm testrun tests
Publishing
- GitHub Actions workflow:
.github/workflows/publish.yml - Triggered on tags matching
v*(example:v0.1.1) or manual run (workflow_dispatch) - Required repository secret:
NPM_TOKEN(npm automation token with publish access)
Keybindings
ddump Brewfile (brew bundle dump --force)rrefresh from Brewfilej/kor arrows move selection/filter listenterfetch selected item source info (brew info/mas info)xdelete selected package (confirmation required)crunbrew cleanup(confirmation required)urunbrew update+brew upgradefor all Homebrew packages (confirmation required)qquit
