A lightweight, native macOS menu bar app to track GitHub releases. Built entirely with Swift and AppKit — no frameworks, no dependencies, no Xcode project required.
Mino.mp4
- 👀 Menu Bar Integration: Unobtrusive status bar icon with inline repository information
- ⚡️ Inline Actions: Hover over any repository to reveal contextual action buttons with expanded, easy-to-click target areas — view release notes, open releases, install via Homebrew, or delete
- 🍺 Homebrew Integration: Detects installed Casks automatically and enables one-click install/update directly from the menu (only shown if Homebrew is installed)
- 🧠 Hybrid Quick Add: Copy a GitHub repository URL, open the menu, and a 1-click "Quick Add" button intelligently appears at the top. Bypass the modal window completely!
- 🎯 Multi-Hunt Window: The floating "Add Repositories..." window acts as a persistent tracking hub. Keep it open while you browse Safari, and simply hit
CMD+Con sequential GitHub URLs. Mino automatically sniffs your clipboard and queues them up for rapid batch-ingestion without ever losing focus. - 📂 Quick Reveal: After installing a Cask, the app reveals the application in Finder
- 🔐 Secure Token Storage: GitHub Personal Access Tokens stored in macOS Keychain — never in plain text
- ✦ Configurable New Release Indicator: Customizable threshold (1-30 days) with toggle, replacing the old fixed emoji
- 🌍 Localized: English, Spanish, French, German, Italian, and Portuguese with automatic system detection
- 🔄 Auto-Start: Launch at login via native macOS LaunchAgent
- 🎨 Light & Dark Mode: Full support, including a forced-dark HUD panel for notifications
- macOS 12.0+
- Xcode Command Line Tools (
xcode-select --install) - Homebrew (optional, for Cask integration)
brew install nad-bit/tap/minogit clone https://github.com/nad-bit/Mino.git
cd Mino/SwiftApp
chmod +x build.sh
./build.shThe compiled app bundle will be at build/Mino.app. Move it to /Applications or run it directly:
open build/Mino.appNote: No Xcode project needed. The
build.shscript compiles all Swift sources directly withswiftc.
Important: If macOS blocks the compiled application from running (saying it's damaged or cannot be verified), remove the quarantine attribute by running:
xattr -dr com.apple.quarantine /Applications/Mino.app
Fastest Way (Hybrid Quick Add):
- Copy any GitHub repository URL to your clipboard.
- Click the Mino menu bar icon. A Quick Add button will instantly appear at the top.
- Click it. You're done.
Multi-Hunt Way (Batch Processing):
Click the (+) button in the menu to open the floating Window.
- Don't close the window! Keep it hovering on your screen.
- Go to your browser, copy a URL (
CMD+C). Watch Mino automatically catch the link. Click the Add button. - The window remains open and the text field clears. Cycle through your browser tabs, copying and adding rapidly.
- Includes a cute, animated visual confirmation (
paw swipe) for successful additions.
Standard Manual Input:
- Enter
owner/repoformat (e.g.,microsoft/vscode). - Toggle the segment to Homebrew to select from your installed Casks.
Each repository displays its name, latest version, and time since release. Hover over a row to reveal action buttons aligned to the right:
| Button | Action |
|---|---|
| 📦 | Install/update via Homebrew (if available) |
| 📄 | View release notes |
| ↗ | Open releases page on GitHub |
| 🗑 | Remove from watch list |
Click the row itself to open the repository's main GitHub page.
Repos with recent releases show a ✦ indicator (configurable in Preferences).
Accessible via the Preferences menu item:
| Option | Description |
|---|---|
| GitHub Account | Connect via OAuth for 5,000 req/hr limit (vs 60/hr unauthenticated) |
| Refresh Interval | Slider: 1-24 hours between auto-checks |
| Start at Login | Toggle macOS LaunchAgent |
| Show Owner Name | Toggle owner/ prefix in repo names |
| New Release Indicator | Toggle the ✦ symbol and configure threshold (1-30 days) |
| Sort by | Segmented control: Date or Name |
| Menu layout | Segmented control: Choose between 4 distinct UI arrangements |
| Menu Density: Compact Mode | Toggle extreme density (shrinks rows from 22pt to 16pt) |
Your GitHub authentication token is stored securely in macOS Keychain:
- Encrypted, never saved in raw config files
- Visible in Keychain Access under "Mino"
- Uses GitHub's official Device Authorization Flow (OAuth)
Configuration is stored in:
~/.config/Mino/repos.json
Note: Tokens are NOT stored in this file — they're in Keychain.
SwiftApp/
├── build.sh # One-step build script (no Xcode required)
└── Sources/
├── main.swift # App entry point
├── AppDelegate.swift # Menu bar, lifecycle, NSMenuDelegate
├── RepoMenuItemView.swift # Custom inline menu item with hover actions
├── SettingsWindowController.swift # Preferences window
├── ConfigManager.swift # JSON config + Keychain management
├── GitHubAPI.swift # GitHub REST API client
├── GitHubAuth.swift # GitHub Device Flow OAuth handling
├── HomebrewManager.swift # Homebrew Cask detection and installation
├── HUDPanel.swift # Floating notification panel
├── UIHandlers.swift # Dialogs and alert helpers
├── Models.swift # Data structures (RepoInfo, AppConfig)
├── Constants.swift # App-wide constants
├── Translations.swift # i18n (English, Spanish, French, German, Italian, Portuguese)
└── Utils.swift # Date formatting utilities
This project is licensed under the MIT License — see the LICENSE file for details.
Built with pure Swift and AppKit. No external dependencies.