Merge requests
Requested reviews and authored work stay together in a focused queue.
Native macOS menu bar app
GitLab, one glance away.
Keep merge requests, assigned issues and pipeline health nearby—without keeping GitLab open all day.
Free to use, not for resale · macOS 14+ · GitLab.com and self-managed
Up to datemenu bar
Local by designToken in Keychain. No analytics.
Your GitLab
Read-only API
Native menu bar
Only the signal.
The app keeps a compact local view of the work that needs attention, preserves the last successful refresh offline and stays quiet until something changes.
Pipeline health
Watch the latest pipeline state across the repositories in your scope.
Assigned issues
See open assignments without turning GitLab into a permanent browser tab.
Private by default
Read-only access, macOS Keychain storage, no telemetry. The only request outside your instance is an anonymous update check you can switch off.
New in 1.0.0.
Your teammates' pushes, in the same place as everything else. And a version number that says what the last ten releases earned: this is stable, and the feature list is the feature list.
1.0.0 also fixes two things the new activity made impossible to ignore: marking everything as seen now clears the whole log rather than the five rows the popover shows, and the detail window's filter no longer slides under the inspector when you open it. Before it, 0.1.10 redrew the menu bar mark as GitLab's tanuki the right way up; 0.1.8 taught the app to update itself from a signed release feed, dropped the App Sandbox that made in-place updates impossible, and shipped a universal build.
Pushes by your teammates
New commits on the projects you watch, with who pushed them and to which branch. Silent by default, because on an active team it is the one thing that happens all day, and one toggle away from notifying.
Report
How often each project went red, how long it took to recover, where the review load sits and what has been open the longest — from what the app already recorded, with no extra API calls.
Update check
Tells you when a newer release exists. Anonymous, no token and no identifier, every six hours, and switchable off in Settings.
Token scoped to your instance
Avatars are loaded with your credential only when their URL is on the instance you configured. Up to 0.1.5 a Gravatar avatar — the GitLab default — could receive it.
About, and a written record
Version, licence and links in a panel of their own, plus SECURITY.md and PRIVACY.md for anyone who has to authorize the app before using it.
Local read state
Acknowledge it on your terms.
Repository work can remain unresolved on GitLab without remaining unread here. Mark an alert as seen locally; a real new event will surface it again.
Repository activity Interaction preview
Pipeline needs attentionRepository event · stored locally
This demonstrates app behavior; it does not represent live repository data.
No developer certificate needed
Install in three steps.
The release is signed but not Apple-notarized. You do not need an Apple Developer account or your own certificate.
Get GitLab Alert 1.0.0Free to use, privately or at work, and free to fork. It may not be sold or bundled into anything sold. If it saves you time, buy me a coffee.
1
Download and move
Open the DMG and drag GitLabAlert.app onto the Applications shortcut.
2
Approve it in macOS
Try opening the app, then use System Settings → Privacy & Security → Open Anyway. If macOS still blocks it, run xattr -dr com.apple.quarantine "/Applications/GitLabAlert.app" once in Terminal.
3
Connect GitLab
Choose your GitLab origin and save a personal access token with only read_api.
Why the command? The release uses a stable self-signed identity, not Apple Developer ID notarization. The targeted command removes only the downloaded-file quarantine flag; xattr -cr removes every extended attribute and is broader than necessary.
The tiny price of free
Yours for one star. Honor system. ⭐
If GitLab Alert earns a place in your menu bar, leave a star on GitHub. It helps other people find the project and tells me it is worth keeping sharp.