All guides

Guides · Setup

Getting started with gbar

Install gbar with the dmg or Homebrew, sign in to GitHub, and get your first glance at the menu bar.

3 min read

gbar installs in under a minute: grab the signed .dmg or run one Homebrew command, sign in to GitHub, and your pull requests are in the menu bar. It runs on macOS 14 or newer.

Install

The release build is Developer ID–signed, notarized and stapled, so it opens with no Gatekeeper prompt. Install it from the Homebrew tap:

terminal · homebrew
brew install --cask jaylann/tap/gbar

Or download the .dmg directly and drag gbar to Applications. Either way you get the identical build; Homebrew users upgrade with brew upgrade --cask gbar.

Sign in

gbar is a menu bar agent: no dock icon, no window on launch. Click the g in your menu bar, then Sign in with GitHub:

  1. gbar shows a one-time code and opens github.com/login/device
  2. Enter the code, approve the app, and you're in. No password ever touches gbar
  3. Prefer a token? Use a token instead accepts a classic personal access token

Auth is GitHub's OAuth device flow: no server, no client secret. Tokens live in the macOS Keychain, never on disk in plaintext.

Your first glance

The dropdown aggregates everything you track on GitHub, refreshed on a configurable poll interval, with a live count badge on the menu bar icon:

SectionShows
Pull requestsCreated / assigned / review-requested / mentioned, with author, approvals, +/− lines and age
IssuesCreated, assigned and mentioned, alongside your PRs
ChecksPer-check pass / fail / pending status on each PR
NotificationsYour inbox, with mark-as-read from the menu
Saved queriesAny GitHub search string as its own section

Rows act, not just show: open in browser, approve, merge and mark read are one click from the menu. Repos you've starred get a star marker on their rows, and a curated watchlist (Settings → Watchlist) feeds two extra tabs: GitHub Actions workflow runs and a "what shipped" releases digest.

More accounts, more hosts

Add multiple accounts side by side, and point gbar at GitHub Enterprise by setting the API base URL in Settings → Advanced, e.g. https://ghe.example.com/api/v3.


Want zero third parties? Run your own OAuth app. Want to hack on it? Build from source.