{"id":31368148,"url":"https://github.com/hzqtc/taproom","last_synced_at":"2026-05-29T06:02:34.202Z","repository":{"id":301636336,"uuid":"1008787160","full_name":"hzqtc/taproom","owner":"hzqtc","description":"An interactive TUI for Homebrew","archived":false,"fork":false,"pushed_at":"2026-05-28T03:45:58.000Z","size":2593,"stargazers_count":598,"open_issues_count":4,"forks_count":11,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-05-28T05:20:21.771Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hzqtc.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-06-26T05:14:19.000Z","updated_at":"2026-05-28T03:43:10.000Z","dependencies_parsed_at":"2025-06-27T23:19:03.093Z","dependency_job_id":"2748ca9f-27c1-429b-8f01-11890fa3344a","html_url":"https://github.com/hzqtc/taproom","commit_stats":null,"previous_names":["hzqtc/taproom"],"tags_count":26,"template":false,"template_full_name":null,"purl":"pkg:github/hzqtc/taproom","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hzqtc%2Ftaproom","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hzqtc%2Ftaproom/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hzqtc%2Ftaproom/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hzqtc%2Ftaproom/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hzqtc","download_url":"https://codeload.github.com/hzqtc/taproom/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hzqtc%2Ftaproom/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33639055,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-29T02:00:06.066Z","response_time":107,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-09-27T15:02:16.782Z","updated_at":"2026-05-29T06:02:34.197Z","avatar_url":"https://github.com/hzqtc.png","language":"Go","funding_links":[],"categories":["Go"],"sub_categories":[],"readme":"`taproom` is featured as \"Tool of the Week\" (July 15, 2025) on [Terminal Trove](https://terminaltrove.com/taproom/), the $HOME of all things in the terminal.\n\n\u003ca href=\"https://terminaltrove.com/taproom\"\u003e\n    \u003cimg src=\"https://cdn.terminaltrove.com/media/badges/tool_of_the_week/svg/terminal_trove_tool_of_the_week_gold_transparent.svg\" alt=\"Terminal Trove Tool of The Week\" width=\"480\" /\u003e\n\u003c/a\u003e\n\n# taproom\n\n`taproom` is a cozy terminal user interface (TUI) for Homebrew. It provides a fast and fluid way to explore formulae and casks directly in your terminal.\n\n![](https://raw.github.com/hzqtc/taproom/master/screenshot.png)\n\n## ⭐ Highlights\n\n`taproom` does a few things faster and easier than the `brew` cli:\n\n- Search: searching in `taproom` gives results with all the details in real time; while using `brew`, you need to run `brew search`, then\n  `brew info` on each package.\n- Dependencies: `brew info` shows direct dependencies; while `taproom` also shows all recursive dependencies that are not installed - this is helpful\n  to understand what exactly would be installed as dependencies\n  - `taproom` also has a clear indication for packages installed as dependencies vs installed explicitly\n- Dependents: `brew uses --eval-all` shows dependents that require the target package, but it is a pretty slow command; `taproom` has this information\n  available without additional data loading\n- Sorting: `taproom` supports sorting by popularity (90d installs) and size (disk space used)\n- Navigation: 'h' opens an app's home page and 'b' opens the brew formula page\n\n## ✨ Features\n\n- **Table View:** Overview of all available formulae and casks in Homebrew.\n- **Detailed View:** Get more info on any package, including its description, version, homepage, license, dependencies, and 90-day install count.\n  - Also shows dependencies recursively (only when the dependencies are not installed)\n  - Also shows dependents (which other packages depend on this one)\n- **Search:** Quickly find packages by keywords\n  - Default: match each keyword in either name or description\n  - Prefix `n:`: match the keyword only in the name\n  - Prefix `d:`: match the keyword only in description\n  - Prefix `t:`: match the keyword only in tap\n  - Prefix `h:`: match the keyword only in the home page\n  - Prefix `-`: turn into a negative keyword, can be combined with prefixes\n    - For example: `ebook -facebook` - search for `ebook` but not `facebook`\n- **Filtering:** View all packages, or filter by:\n  - Formulae only\n  - Casks only\n  - Installed packages\n  - Outdated packages\n  - Packages you installed explicitly (not as dependencies)\n- **Flexible Sorting:** Sort packages alphabetically by name or by 90-day popularity.\n- **Status Indicators:** See at a glance which packages are installed, outdated, or pinned.\n- **Execute brew commands:** upgrade, install, uninstall, pin, or unpin packages directly in the TUI.\n\n## 🚀 Getting Started\n\n### Dependencies\n\n- A terminal emulator with a [nerd font](https://www.nerdfonts.com/)\n- `du` (MacOS builtin command)\n- `brew` [Homebrew](https://brew.sh/)\n- `gh` [Github CLI](https://github.com/cli/cli)\n  - Optional, used for getting release info when `--fetch-release` flag is set\n\n### Install from pre-built binary\n\n`gromgit@` (Thank you!) maintains a [formula](https://github.com/gromgit/homebrew-brewtils/blob/main/Formula/taproom.rb):\n\n```\nbrew install gromgit/brewtils/taproom\n```\n\nOr use [`eget`](https://github.com/zyedidia/eget):\n\n```\neget hzqtc/taproom\n```\n\n### Build from source\n\nTo build from source, follow these simple steps:\n\n#### Build dependencies\n\n- [Go](https://go.dev/doc/install)\n\n#### Build\n\n1.  Navigate to the project directory.\n2.  Build the binary:\n    ```sh\n    make\n    ```\n3.  Run the application:\n    ```sh\n    ./taproom\n    ```\n\n## 🪄 Customization\n\nThe app's behavior can be further customized with command-line flags:\n\n- `--invalidate-cache` or `-i` in short: invalidate cache and re-download data from brew.sh\n- `--fetch-release`: fetch release information for installed packages. This flag enables displaying the release date and the 'r' key to open the release page\n  - Note: release information is only available when the homebrew URL or home page points to a GitHub repo with releases\n  - About 60% packages would show the release date and support 'r' to open the release page with this flag enabled\n  - Requires `gh` (Github CLI) to be in the PATH\n- `--hide-columns`: hide and skip loading data for specified columns\n  - This can be helpful to further simplify the UI\n  - While all data loading is done in parallel, some may be slower than others. This flag can be used to skip loading certain data to speed up app load\n- `--load-timer` or `-t` in short: show a timer in the loading screen\n- `--hide-help`: hide the help text at the bottom of the app\n- `--sort-column` or `-s` in short: specify the column to sort by (this can still be changed in app with `s` and `S` keys)\n- `--filters` or `-f` in short: specify initial filters (can still be changed later in the app)\n- `--theme`: color theme for light/dark terminal backgrounds (`auto`, `light`, `dark`; default: `auto`)\n  - By default, taproom auto-detects your terminal's background color and picks a matching palette\n  - Use `--theme light` or `--theme dark` to override if auto-detection doesn't work for your terminal\n\nRun `taproom -h` to learn more about the command line flags.\n\n## 🛠️ Built With\n\n- [Go](https://go.dev/)\n- [Bubble Tea](https://github.com/charmbracelet/bubbletea)\n- [Bubbles](https://github.com/charmbracelet/bubbles)\n- [Lip Gloss](https://github.com/charmbracelet/lipgloss)\n\n## 🔀 Alternatives\n\n`taproom` is inspired by [`boldbrew`](https://github.com/Valkyrie00/bold-brew) but it's not a clone.\n\n- `taproom` has a different UI style\n- `taproom` supports casks\n- `taproom` supports sorting by different columns\n- `taproom` shows missing dependencies recursively (i.e. dependencies of dependencies)\n- `taproom` shows reverse dependencies (i.e. used by) that replaces a very slow `brew uses \u003cformula\u003e --eval-all` command\n- `taproom` shows the size of installed packages\n\n## ✨ Star History\n\n[![Star History Chart](https://api.star-history.com/svg?repos=hzqtc/taproom\u0026type=Date)](https://www.star-history.com/#hzqtc/taproom\u0026Date)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhzqtc%2Ftaproom","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhzqtc%2Ftaproom","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhzqtc%2Ftaproom/lists"}