RepoBar

RepoBar is a native macOS menu bar app for maintainers who track many GitHub repositories. It keeps issue and pull request counts, CI, releases, activity, rate limits, and local checkout state in one menu.

Repository dashboard

The main menu shows issue and pull request pressure, stars, forks, recent activity, CI state, releases, and contribution heatmaps. Filters narrow the list to pinned repositories, local checkouts, or repositories with active work.

Choose Light, Dark, or System Default under Preferences → General → Display → Appearance. RepoBar applies the choice to its menus and windows; System Default follows macOS. The CLI also accepts repobar settings set color-scheme light|dark|system, which takes effect on the next app launch.

Choose Repository heatmap → Submenu in Preferences → General → Display to show activity inside each repository menu. Changing Heatmap color takes effect the next time you open that submenu.

Each repository opens a submenu with recent GitHub activity and, when a local checkout is configured, its branch, upstream, dirty files, ahead/behind state, and worktrees. RepoBar can open the checkout in Finder or a terminal and can fast-forward clean repositories without discarding local changes.

Preferences → Repositories searches the repositories available to the active account. Search covers names, descriptions, languages, and topics; visibility rules remain visible when an account temporarily loses access, which makes permission problems easier to diagnose.

Authentication and private repositories

RepoBar supports GitHub.com and GitHub Enterprise. GitHub.com login uses a GitHub App user token, so access is limited by both the signed-in user and the repositories where the RepoBar GitHub App (opens in a new tab) is installed.

Install the GitHub App on an organization to expose its private repositories. A Personal Access Token with repository and organization read access is available for SAML SSO or repositories outside that installation boundary. GitHub Enterprise uses its configured HTTPS host and OAuth settings.

Release builds store credentials in the macOS Keychain. Debug builds use file-backed storage to avoid Keychain prompts; [auth storage](docs/auth-storage.md) documents the exact behavior.

Local projects

Choose a projects folder in Preferences → Advanced → Local Projects to match GitHub repositories with local checkouts. RepoBar reports branches, worktrees, dirty files, and upstream state; optional auto-sync runs only for clean, non-detached repositories that can fast-forward.