An interactive TUI (Terminal User Interface) browser for Homebrew packages. Brewse provides a fast, user-friendly way to search, view, and install or uninstall Homebrew packages.

brew install jonasjancarik/tap/brewse

The Homebrew formula warms Brewse's package cache during installation. To keep the cache warm automatically, enable the optional daily refresh service:

brew services start jonasjancarik/tap/brewse

brew install does not start the background service by itself; use brew services start jonasjancarik/tap/brewse only if you want the daily refresh. For a one-time cache refresh without the background service, run:

"$(brew --prefix jonasjancarik/tap/brewse)/bin/brewse" --prefetch

Launch Brewse in one of two ways:

1. Interactive search mode:

brewse

2. Direct search mode:

brewse <search-term>

brewse --help            # Show all available options
brewse --version         # Show version number
brewse --refresh         # Force refresh of cached package data
brewse --prefetch        # Download package data into the cache and exit
brewse --clear-cache     # Clear all cached data and exit

Brewse caches package data in ~/.cache/brewse/ to improve performance. Cache entries expire after 24 hours.

brewse --prefetch refreshes the same cache without starting the TUI. This is intended for Homebrew's install hook and optional brew services daily refresh.

pip install brewse

Run in an isolated environment with pipx:

pipx install brewse

Or run instantly without installation using uvx:

uvx brewse

Note: uvx requires uv to be installed first:

brew install uv

Brewse uses automated releases with GitHub Actions:

1. Update version in pyproject.toml and src/brewse/__init__.py
2. Build and publish to PyPI:

   uv build
   uv publish

3. Create a GitHub release:

   gh release create v0.4.0 --generate-notes

The GitHub Action will automatically:

• Download the tarball from PyPI
• Calculate the SHA256 hash
• Update the Homebrew tap formula
• Push changes to the homebrew-tap repository

See .github/AUTOMATION_SETUP.md for setup details. (Useful if you want to fork this repo, obviously you will need to change the GitHub username.)

If needed, you can manually update the Homebrew tap:

cd ~/homebrew-tap
./update-formula.sh 0.4.0

This project is licensed under the MIT License. See the LICENSE file for details.