Optional menu bar extra / menulet showing outdated packages

Open
#267 6 comments 5 reactions 1 assignee View on GitHub

Maintainers usually reply within 1 day

@graeme is already working on this.

Since Oct 14, 2026.

Assessment

Difficulty
4/5
Estimated time
3-5 days
Newbie friendliness
22/100
Issue type
Feature
Clarity
Mostly clear
Activity status
Active
Tech stack
macos, swift
Domain
desktop

Research direction

The payload names no source files, so start by finding where BrewUI already runs brew outdated and routes commands through its command console, and where the Settings toggle would live. A first step is to confirm how the app's window and scene setup handles a menu bar extra. Done means the opt-in extra is off by default, shows an outdated count, lists installed and available versions, and its upgrade action opens the main window's console.

Written by the indexing model from the issue text.

Description

Before submitting
  • I have searched the issues and pull requests for duplicates.
  • I am proposing a specific improvement to BrewUI with a use case and a clear outcome.
Problem and use case

Knowing when packages are outdated currently requires opening BrewUI directly (or running brew outdated).

Brewlet offers a useful alternative: a MacOS "menulet", which always appears in the MacOS menu bar. It has not had a release since v1.7.4 (April 2023) and its cask is now disabled.

Proposed behaviour

An opt-in menu bar extra (off by default, toggled in Settings) that:

  • Shows the number of outdated formulae and casks (icon/badge; nothing shown when up to date).
  • Lists outdated packages with installed → available versions.
  • Offers "Check for updates", "Upgrade all…" and "Open BrewUI". Upgrades open the main window and run through the existing command console, so the exact brew commands remain visible.
  • Optionally refreshes on an interval and posts a notification when new upgrades appear. Background work would be read-only (brew update/brew outdated); nothing is upgraded automatically.
Alternatives considered
  • Running brew outdated manually.
  • Third-party menu bar apps: Brewlet is unmaintained/disabled; others exist but aren't first-party.
  • Dock badge only: less visible when BrewUI isn't running.
macOS and Homebrew context

macOS 26 (Tahoe) on Apple silicon, Homebrew 7.x, BrewUI installed via brew install --cask homebrew-app.

Dominant language
Swift
Stars
2.8k
Forks
94
Avg merge
18h 12m
Merged PRs (30d)
17

Getting set up

  • No Dockerfile or Docker Compose file
  • Has a pull request template
  • No contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from Homebrew/BrewUI

All issues in Homebrew/BrewUI

Similar issues

More Swift issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.