MCPcopy Index your code
hub / github.com/cosmincatalin/brew-explorer

github.com/cosmincatalin/brew-explorer @v0.2.1

Chat with this repo
repository ↗ · DeepWiki ↗ · release v0.2.1 ↗ · + Follow
117 symbols 255 edges 11 files 87 documented · 74%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

Built With Ratatui

🍺 Brew Explorer

A beautiful terminal UI for exploring and managing your Homebrew packages with ease.

What is Brew Explorer?

You know how after some time you run brew list and see a bunch of packages you have no idea about? Me too! It's frustrating to figure out what those packages do without copy/pasting their names into brew.sh and only then discovering what they're good for.

That's why I created Brew Explorer - a little app that makes it easy to understand what formulaes and casks you have installed on your system.
Plus, you can quickly uninstall old useless things and update whatever was left behind - all from within the same interface!

But why stop at Homebrew? If you're a Mac user, you likely have apps from the Mac App Store too. That's where mas comes in — a brilliant command-line interface for the Mac App Store that brings it under the same terminal-native workflow. Brew Explorer integrates with mas to give you a unified view of your Mac software, whether it came from Homebrew or the App Store — though it works perfectly fine without it too.

Screenshots

Loading Screen

Loading Screen

Main Screen

Main Screen

Search and Uninstall

Uninstall

Features

Appealing TUI - Clean, intuitive terminal interface with ASCII art
🔍 Search functionality - Quickly find packages by name
📦 Package details - View descriptions, homepages, versions, and more
🔄 Update packages - Update outdated packages with a single keystroke
🗑️ Uninstall packages - Remove packages you no longer need
🎨 Color-coded status - Green for up-to-date, red for outdated packages
Fast navigation - Multi-column layout for efficient browsing
🚀 Auto-sync - Runs brew update on startup for fresh package information
🍎 Mac App Store support - Browse and manage App Store apps via mas

Installation

Prerequisites

  • macOS (Homebrew is macOS-specific)
  • Homebrew installed
  • mas (brew install mas) — optional, enables Mac App Store integration

Steps

brew tap cosmincatalin/tap
brew install brew-explorer

Navigation

  • ↑/↓ or k/j - Move up/down in the package list (Vim-style)
  • ←/→ or h/l - Move left/right between columns (Vim-style)
  • PgUp/PgDn - Jump by pages
  • Home/End - Jump to first/last package

Actions

  • / - Start searching for packages
  • u - Update the selected package
  • x - Uninstall the selected package
  • q - Quit the application

Search Mode

  • Type any character to search for packages by name
  • Enter or Esc - Exit search and return to browsing
  • Navigation keys (↑/↓/←/→ or k/j/h/l) still work while searching

Core symbols most depended-on inside this repo

add_status_message
called by 23
src/app.rs
reset_scroll
called by 10
src/app.rs
ensure_selection_visible
called by 9
src/app.rs
has_update_available
called by 6
src/entities/package_info.rs
get_selected_package
called by 4
src/app.rs
refresh_packages_with_selection
called by 3
src/app.rs
first
called by 3
src/app.rs
apply_filter
called by 3
src/app.rs

Shape

Method 58
Function 54
Class 3
Enum 2

Languages

Rust100%

Modules by API surface

src/app.rs42 symbols
src/helpers.rs25 symbols
src/repository.rs14 symbols
src/ui.rs13 symbols
src/entities/package_info.rs10 symbols
src/entities/brew_info_response.rs6 symbols
src/events.rs4 symbols
src/main.rs2 symbols
src/entities/mas_app.rs1 symbols

For agents

$ claude mcp add brew-explorer \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page