macpak is an interactive command-line wrapper designed to simplify the usage of Homebrew on macOS. By providing a fuzzy-finder interface with live previews, macpak allows users to effortlessly browse, install, and uninstall Homebrew packages, significantly reducing the need for repetitive typing of commands. Additionally, macpak features a zapper tool that ensures complete removal of applications installed outside of Homebrew, including any residual files.

Key Features

• Fuzzy Search: Quickly find Homebrew formulas and casks using a fuzzy search algorithm.
• Interactive Workflow: Navigate an intuitive install and uninstall flow to streamline package management.
• Zapper Functionality: Effectively remove non-brew applications and their associated leftovers from the system.
• Cached Index: Experience faster searches and operations through a cached index of Homebrew packages.
• Diagnostic Command: Use the doctor command to perform sanity checks on the required and optional tools for operation.

Requirements

• Homebrew: Must be installed on the system.
• fzf: Automatically installed if not present.

Usage Examples

macpak search [query]          # Search available Homebrew formulae and casks; Enter to install
macpak list [query]            # List installed Homebrew formulae and casks; Enter to uninstall
macpak zap <keyword>           # Remove non-brew apps along with leftovers
macpak cache-refresh           # Refresh the cached Homebrew index
macpak doctor                  # Check required and optional tools and configuration

For comprehensive guidance on configuration settings, refer to the documentation and explore the story behind macpak for insights into its development.