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

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 --clear-cache     # Clear all cached data and exit

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

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.3.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.3.0

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