Cellar

A native macOS app for managing Homebrew packages, casks, and services.

---

Features

• Dashboard — Overview of installed packages, services, and system health at a glance
• Package Management — Browse, install, upgrade, and uninstall formulae and casks
• Services — Start, stop, and monitor Homebrew services with real-time status
• Dependency Graph — Visualize package dependencies interactively
• Resource Monitor — Track Homebrew disk usage and system resources
• Maintenance — Run cleanup, doctor checks, and manage taps
• Brewfile Support — View and manage Brewfiles from your projects
• Search — Find new packages with integrated search
• Widget — Desktop widget with small, medium, and large sizes
• CLI Tool — cellar command-line tool for quick terminal operations
• Finder Integration — Badges directories containing Brewfiles, right-click service controls
• Spotlight — All installed packages indexed for system-wide search
• Automatic Updates — Signed GitHub Releases are checked, downloaded, and installed securely in-app

Screenshots

Installation

Download

Download the latest .dmg from the Releases page. Open the .dmg and drag Cellar to your Applications folder.

After the first installation, Cellar checks the signed GitHub Releases feed daily. Automatic download and installation can be changed under Settings → About → Updates.

Requirements

• macOS 15 or later
• Homebrew installed

Build from Source

git clone https://github.com/tuhage/Cellar.git
cd Cellar
xcodebuild -project Cellar.xcodeproj -scheme Cellar -configuration Release build -allowProvisioningUpdates

Publishing an Update

Sparkle verifies every update with the public Ed25519 key embedded in Cellar and the app's Developer ID signature. The matching private key stays in the maintainer's macOS Login Keychain and must never be committed.

Increment both the user-facing version and the monotonically increasing build number, then run:

./scripts/release.sh 1.6.0 15

The script produces the notarized DMG and a signed build/appcast/appcast.xml. Upload both assets to the same GitHub Release:

gh release create v1.6.0 \
  build/Cellar-1.6.0.dmg \
  build/appcast/appcast.xml \
  --title "Cellar 1.6.0" \
  --generate-notes

Cellar reads the feed from releases/latest/download/appcast.xml; releases without that asset cannot be installed in-app. Back up the Sparkle private key to secure offline storage before publishing the first update.

CLI Tool

Cellar includes a command-line tool for quick terminal access:

cellar status              # Package and service summary
cellar start <service>     # Start a service
cellar stop <service>      # Stop a service
cellar health              # Run brew doctor
cellar cleanup             # Clean up old downloads and cache

URL Scheme

Open specific sections directly via cellar:// links:

cellar://formula/<name>
cellar://cask/<token>
cellar://dashboard
cellar://services

License

MIT — see LICENSE for details.