Swiftbar Plugins

A small collection of SwiftBar plugins for personal workflow automation and visibility.

This repository is not one single app. It is a home for multiple standalone menu bar plugins, each with its own purpose, setup requirements, and operational behavior.

What to expect

• Each plugin lives in its own folder.
• Each plugin folder contains:
  • the actual SwiftBar script
  • a local README explaining what it does, how it works, and what it needs
• Plugins are meant to make sense on their own.
• More plugins can be added over time without turning the repo into one giant undocumented pile.

Current plugins

• github-org-builds/ — GitHub Actions watcher for org-wide queued, running, and failed builds
• drone-builds/ — Drone CI watcher for active repos, including running and failed builds

SwiftBar

SwiftBar lets you run scripts from the macOS menu bar on a refresh interval.

Project: https://github.com/swiftbar/SwiftBar

Installation model

This repo is organized for maintainability, not for direct drop-in execution from the repo root.

To use a plugin:

1. open the plugin’s folder
2. read its README
3. copy the .sh file into the SwiftBar plugin directory you chose when setting up the SwiftBar app
4. make it executable
5. refresh SwiftBar

If you do not remember where that plugin directory is, open the SwiftBar Preferences panel and check the configured Plugin Directory there.

Why the structure is like this

SwiftBar plugins tend to start simple and then quietly grow weird little personalities. Keeping each plugin in its own directory avoids:

• one bloated top-level README
• undocumented env var drift
• mystery scripts with no context
• future me committing fresh crimes