Skip to content

Repository files navigation

BlackBar ⚒️ — The forge at a glance

CIGitHub releasemacOS 14+LicenseHomebrewWebsite

BlackBar — your Blacksmith status, in your menu bar

BlackBar is a native macOS menu bar app for people who use Blacksmith CI. It shows service health, current runner load, and active jobs without keeping the dashboard open.

Important

BlackBar is an independent third-party tool. It is not affiliated with, sponsored by, or endorsed by Blacksmith.

BlackBar menu showing vCPU history, workflow run history, service status, and active jobs

Install

BlackBar requires macOS 14 or later. Install the signed app with Homebrew:

brew install --cask steipete/tap/blackbar

Alternatively, download BlackBar-*.zip from the latest GitHub release, unzip it, and move BlackBar.app to /Applications.

Quick start

Launch BlackBar:

open -a BlackBar

Then click its menu bar item, choose Login with GitHub, and finish the Blacksmith sign-in in the WebKit window. The app has no Dock icon.

The Blacksmith session cookie is stored in macOS Keychain and cached in memory while the app is running. Sign Out removes it.

What it shows

  • Blacksmith service health from the public status feed.
  • Current and historical vCPU use, job counts, and queued work.
  • Active job details and amd64, arm64, and macos usage.
  • Optional notifications for status changes, incidents, and completed jobs.
  • PNG export for the usage and workflow graphs from their context menus.

Use Settings… to select a GitHub organization, filter to one repository, change the refresh interval, enable notifications, or launch BlackBar at login. Fresh settings use the openclaw organization, include every visible repository, refresh every 60 seconds, and leave notifications off.

Data and privacy

BlackBar requests public health data from status.blacksmith.sh and authenticated usage data directly from Blacksmith's dashboard API. The signed app uses a GitHub-hosted Sparkle feed and GitHub Releases for updates, and user actions can open Blacksmith or GitHub pages.

There is no BlackBar-operated proxy or backend, and the app includes no analytics or crash-reporting service. See VISION.md for the project's product and privacy principles.

Development

Building requires macOS 14 or later and a Swift 6 toolchain.

make ci # tests, release build, and app bundle
make app # assemble build/BlackBar.app

The executable target lives in Sources/BlackBar/; bundle metadata and artwork live in Resources/ and Assets/. The static site at black.bar lives in docs/.

Maintainers can follow the release procedure for signing, notarization, Sparkle, and GitHub Releases.

Trademark notice

"Blacksmith" and the Blacksmith logo are trademarks of their respective owners. Questions about the name can be sent to steipete@gmail.com or opened as an issue.

License

MIT © Peter Steinberger.

About

Your Blacksmith CI status, in your menu bar.

Topics

Resources

Stars

49 stars

Watchers

2 watching

Forks

Releases

Contributors

Languages