Skip to content

scasella/BrewPilot

Repository files navigation

BrewPilot

A native macOS menu bar app for managing Homebrew services. Start, stop, and restart services like Redis, PostgreSQL, nginx, and MySQL with one click — no terminal needed.

BrewPilot screenshot

Why it exists

I got tired of typing brew services list and brew services start redis a dozen times a day. Every developer with Homebrew services does this — it's muscle memory at this point. I wanted to see what's running at a glance and toggle it with one click. BrewPilot is what happens when you decide a three-word terminal command still has too much friction.

Install

# Clone or download, then build
cd BrewPilot
chmod +x build.sh
./build.sh

# Launch
open BrewPilot.app

Or compile manually:

swiftc -parse-as-library -o BrewPilot BrewPilot.swift
./BrewPilot

Quickstart

  1. Run ./build.sh to build the .app bundle
  2. Run open BrewPilot.app
  3. Look for the mug icon in your menu bar
  4. Click it to see all your Homebrew services
  5. Hover over a service to reveal Start/Stop/Restart buttons
  6. Click a button — the service state changes immediately

Examples

See all services at a glance: The menu bar icon shows "3/7" — 3 of your 7 services are running.

Start Redis: Click the mug icon → hover over "redis" → click the green play button.

Stop PostgreSQL: Click the mug icon → hover over "postgresql@16" → click the red stop button.

Restart nginx: Click the mug icon → hover over "nginx" → click the orange restart button.

Empty state: If you have no Homebrew services installed, BrewPilot shows a helpful message explaining how to install services.

Features

  • Live service list from brew services list --json
  • Color-coded status: green (running), gray (stopped), red (error)
  • One-click start, stop, restart
  • Auto-refresh every 5 seconds
  • Running count in menu bar (e.g., "3/7")
  • No dock icon (menu bar only)
  • Native Swift + SwiftUI, no dependencies

Requirements

  • macOS 14.0+ (Sonoma)
  • Homebrew installed (/opt/homebrew/bin/brew or /usr/local/bin/brew)
  • Swift compiler (swiftc) — comes with Xcode or Xcode Command Line Tools

Troubleshooting

"Homebrew not found" error: BrewPilot looks for brew at /opt/homebrew/bin/brew (Apple Silicon) and /usr/local/bin/brew (Intel). Make sure Homebrew is installed: https://brew.sh

No services listed: You need to install Homebrew formulae that provide services. Examples:

  • brew install redis
  • brew install postgresql@16
  • brew install nginx
  • brew install mysql

Menu bar icon not visible: If you have many menu bar icons, BrewPilot's mug icon may be hidden by the notch or by a menu bar manager. Try using Ice or Bartender to reveal hidden icons.

Service won't start: Some services require specific configuration. Check brew services info <service> in the terminal for details.

License

MIT

About

macOS menu bar app for managing Homebrew services — start, stop, restart with one click

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors