A macOS menu bar app for managing Homebrew services
A macOS menu bar app for managing Homebrew services. Start, stop, and restart services without the terminal.
- Lists every
brew servicesentry with its status, and refreshes on a schedule you choose - Start, stop, restart, run, or kill a service, or act on all of them at once
- Shows the ports a running service listens on, including ports opened by its child processes
- Saves links to a service's web interface, such as
http://localhost:8384for Syncthing - Manages user services and system (root) services; system actions ask for your administrator password
- Can launch at login and check for updates
- Debug mode shows the full Homebrew output when something fails
- macOS 15.0 (Sequoia) or later
- Homebrew installed and configured
- Services installed via Homebrew (e.g.,
brew install postgresql,brew install redis)
brew install --cask validatedev/tap/brew-services-manager- Download the latest
.dmgfrom the Releases page - Open the DMG and drag Brew Services Manager to your Applications folder
- Launch the app from Applications or Spotlight
-
Clone the repository:
git clone https://github.com/validatedev/BrewServicesManager.git cd BrewServicesManager -
Open the project in Xcode:
open BrewServicesManager.xcodeproj
-
Configure Code Signing (first time only):
# Copy the development config template cp Config/Development.shared.xcconfig Config/Development.xcconfig # Edit the file and replace YOUR_TEAM_ID with your Apple Developer Team ID # You can find your Team ID at: https://developer.apple.com/account # OR in Xcode: Settings → Accounts → [Your Account] → Team ID nano Config/Development.xcconfig
-
Build and run (⌘R) or archive for distribution (Product → Archive)
- Launch the app. It runs only in the menu bar, as a mug icon.
- Click the icon to see your Homebrew services and their status.
- Each service row has a Start or Stop button for the common case.
- The More Actions (⋯) button opens the rest: Run (one-shot), Start at Login, Restart, Stop with Options…, Kill, Manage Links…, View Info, Open in Finder, and Copy File Path.
When you open More Actions or View Info for a running service, the app looks up the ports that the service and its child processes listen on. This covers services that spawn workers, such as Syncthing and nginx.
- More Actions shows the first three ports, for example
8384, 22000. - View Info lists every port with its protocol (TCP or UDP).
Add custom URLs to quickly access service web interfaces:
- Click More Actions (⋯) on a service and choose Manage Links…
- Add a link:
- Click a suggested URL (built from the detected ports), or
- Click Add Custom Link and enter any URL
- Optionally give it a label, such as "Admin Panel" or "Metrics"
- The first two links appear as buttons on the service row. All of them are listed under More Actions.
Examples:
- Syncthing →
http://localhost:8384(Web UI) - Local API →
http://localhost:3000(Development server) - nginx →
http://localhost:80(Web server)
Links are saved automatically and persist across app restarts.
Brew Services Manager supports two service domains:
| Domain | Description | Privileges |
|---|---|---|
| User | Services running under your user account | Standard user permissions |
| System | System-wide services (root-level) | Requires administrator password |
Switch domains with the selector in the menu header, or in Settings → Domain.
Perform bulk operations on all services:
- Start All: start every service and register it to run at login
- Stop All: stop every running service
- Restart All: restart every service
- Cleanup: remove unused service files
Open Settings… from the menu:
- Domain: User or System
- Run system services as: the user passed to
--sudo-service-userfor system services; leave it empty for root - Auto-refresh: Disabled, 30 seconds, 1 minute, or 5 minutes
- Launch at login: start the app when you log in to macOS
- Automatically check for updates, plus a Check for Updates… button
- Debug mode: show detailed Homebrew output
- Xcode 26.0 or later
- macOS 15.0 or later (for running)
- Homebrew (for testing service management)
- Apple Developer account (free or paid, for code signing)
Before building, you need to configure code signing:
- Open the project in Xcode
- Select BrewServicesManager project → BrewServicesManager target
- Go to Signing & Capabilities
- Select your team from the dropdown
The project does not include a hardcoded development team, allowing each contributor to use their own Apple Developer account.
# Build for development
xcodebuild -scheme BrewServicesManager -configuration Debug build
# Build for release
xcodebuild -scheme BrewServicesManager -configuration Release build
# Run tests
xcodebuild -scheme BrewServicesManager testBrew Services Manager can't find Homebrew
Ensure Homebrew is installed and accessible:
# Check if brew is in PATH
which brew
# If using Apple Silicon, ensure /opt/homebrew/bin is in PATH
echo $PATHBrew Services Manager searches for Homebrew in:
/opt/homebrew/bin/brew(Apple Silicon)/usr/local/bin/brew(Intel)
Services show "Error" status
- Open More Actions (⋯) on the service and choose View Info
- Check the error message and exit code
- Enable Debug Mode in Settings for verbose output
- Verify the service plist is valid:
brew services info <service-name>
Port detection not showing any ports
Port detection only works for running services. Ensure:
- The service is actually running (status shows "started")
- The service is listening on TCP/UDP ports
- You have the necessary permissions to run
lsof
To verify manually:
# Check if service is listening
lsof -nP -iTCP -sTCP:LISTEN | grep <service-name>System authentication dialog appears but can't be clicked
This issue has been fixed in recent versions. If you encounter this:
- Update to the latest version of Brew Services Manager
- The authentication dialog should now accept mouse input properly
- If issues persist, you can still use keyboard navigation (Tab to move between fields, Space/Enter to click buttons)
This project is licensed under the MIT License — see the LICENSE file for details.
- Homebrew — The missing package manager for macOS
- SF Symbols — Apple's iconography system
- SwiftAgents - Base
AGENTS.mdfile for best practices
Made with 🦆
