https://github.com/kavindujayarathne/macpak
Interactive wrapper that makes Homebrew much easier to use + zapper for non-brew apps
https://github.com/kavindujayarathne/macpak
cli-tool homebrew homebrew-tap mac macos macpak open-source wrapper-script
Last synced: 27 days ago
JSON representation
Interactive wrapper that makes Homebrew much easier to use + zapper for non-brew apps
- Host: GitHub
- URL: https://github.com/kavindujayarathne/macpak
- Owner: kavindujayarathne
- License: mit
- Created: 2025-10-06T21:56:04.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2026-04-15T16:02:18.000Z (about 1 month ago)
- Last Synced: 2026-04-15T18:08:16.254Z (about 1 month ago)
- Topics: cli-tool, homebrew, homebrew-tap, mac, macos, macpak, open-source, wrapper-script
- Language: Shell
- Homepage: https://kavindujayarathne.com/blogs/macpak-documentation
- Size: 13.3 MB
- Stars: 7
- Watchers: 1
- Forks: 0
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# macpak
macpak is an interactive wrapper around Homebrew for macOS. It lets you browse, install, and
uninstall Homebrew packages through a fuzzy-finder interface with live previews, so you spend less
time typing commands and more time getting things done. It also includes a zapper that can
completely remove applications installed outside of Homebrew, along with their leftovers.
Read more:
- [Documentation](https://kavindujayarathne.com/blogs/macpak-documentation)
- [Story behind macpak](https://kavindujayarathne.com/blogs/journey-of-macpak)
## Demo
https://github.com/user-attachments/assets/e48d35ab-a2e6-4638-93f8-44e948f35722
## Features
- Fuzzy search Homebrew formulas & casks
- Interactive install/uninstall flow
- Zapper for non-brew apps (app + leftovers)
- Cached index for speed
- Doctor command for sanity checks
## Requirements
- [Homebrew](https://brew.sh/) (must be installed on the system)
- [fzf](https://github.com/junegunn/fzf) (installed automatically if missing)
## Installation
Install via [Homebrew](https://brew.sh/) to get autoupdates (Preferred):
```bash
brew install --formula kavindujayarathne/macpak/macpak
```
## Usage
```bash
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 Sweep and remove non-brew apps with leftovers
macpak cache-refresh Refresh the cached Homebrew index
macpak doctor Check required/optional tools and config
```
> [!NOTE]
> For environment variables and advanced configuration via `~/.config/macpak/config.sh`,
> see the [documentation](https://kavindujayarathne.com/blogs/macpak-documentation).
## License
This project is licensed under the [MIT License](LICENSE).
## Contributing
Contributions, issues, and feature requests are welcome!
Please also feel free to open an issue if you run into bugs or have feature suggestions.