Skip to content

Repository files navigation

brewkeeper - Beta

CI

brewkeeper is a polished terminal UI for Homebrew upgrades, focused on safer decisions and fast review.

Brewkeeper TUI screenshot

It highlights:

  • major/minor/patch upgrade type
  • dependency impact (brew uses)
  • risk signals and caveats
  • formula + cask support
  • safe-upgrades-only mode
  • snapshot/rollback support (Brewfile-based)

Install

Homebrew (recommended)

brew tap Pallepadehat/brewkeeper
brew install brewkeeper

From source

bun install
bun run build
./dist/brewkeeper

Usage

brewkeeper            # launch the TUI
brewkeeper --version  # print version
Key Action
j / k Navigate packages
Space Toggle selection
a Select / deselect all
f Search Homebrew repos
i Install selected search result (inside repo search)
s Toggle safe-mode
u Upgrade selected
b Create named snapshot
v Open snapshot list
d Delete selected snapshot (inside snapshot list)
? Show keyboard help
r Refresh
q Quit

Development

  • Runtime: Bun ≥ 1.2
  • UI framework: OpenTUI + React
  • TypeScript strict mode enabled
bun install
bun dev

Build

bun run typecheck
bun run build

This produces a standalone binary at dist/brewkeeper.

Contributing

Contributions are welcome. Please read:

Changelog

License

MIT — see LICENSE.

About

No description, website, or topics provided.

Resources

Contributing

Security policy

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages