brewse 0.3.0

An interactive TUI browser for Homebrew packages

Brewse

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.

Installation

Using Homebrew (recommended)

brew install jonasjancarik/tap/brewse

Usage

Launch Brewse in one of two ways:

1. Interactive search mode:

brewse

2. Direct search mode:

brewse <search-term>

Command-line Options

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

Cache

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

Alternative Installation Methods

Using pip

pip install brewse

Using pipx or uvx

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

Development & Releases

Release Process

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.)

Manual Tap Update

If needed, you can manually update the Homebrew tap:

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

License

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