HarborBar

HarborBar is a native macOS menu bar app for developers. It gives you a clear view of local runtimes, databases, and custom projects, and lets you start/stop them quickly.

Features

• Menu bar dashboard for active local services
• Tool detection and grouping (runtimes, databases, tooling)
• Tool and project icons
• Add custom projects with command, directory, port, and icon
• Start/stop custom projects from the menu
• Check for updates from GitHub Releases (stable channel)

Preview

Installation

1. Go to the GitHub Releases page.
2. Download HarborBar-macOS.zip.
3. Unzip and move HarborBar.app to your Applications folder.
4. Open the app.

Notes:

• Current v1 distribution is unsigned/not notarized.
• You may need to allow opening from System Settings on first launch.
• If macOS quarantines the app, run: xattr -dr com.apple.quarantine /Applications/HarborBar.app.

Build and Run Locally

Requirements:

• macOS 15+
• Xcode/Swift toolchain with Swift 6+

Commands:

swift build
swift test
./build.sh
open -n "$(pwd)/HarborBar.app"

Updates

HarborBar includes a manual in-app updater:

• Use Check for Updates… from the app panel.
• It checks stable GitHub Releases (/releases/latest).
• If a newer version exists, the app opens the ZIP download link.
• Installation is manual: replace the old app with the new one.

Configuration

build.sh supports optional environment overrides:

• APP_VERSION (default: 0.1.0)
• APP_BUILD (default: timestamp)
• GITHUB_REPO_OWNER
• GITHUB_REPO_NAME

These values are embedded in Info.plist and used by the updater.

Contributing

1. Fork the repo.
2. Create a feature branch.
3. Run swift build and swift test.
4. Open a pull request.

Third-Party Notices

See THIRD_PARTY_NOTICES.md for bundled icon attribution.

Roadmap

• Signed + notarized app distribution
• Sparkle/appcast OTA updates
• Optional prerelease update channel toggle

License

MIT. See LICENSE.