RepoBar

# RepoBar 🚦 — GitHub without the tab sprawl

[![CI](https://img.shields.io/github/actions/workflow/status/steipete/RepoBar/ci.yml?branch=main&style=flat-square&label=ci)](https://github.com/steipete/RepoBar/actions/workflows/ci.yml)
[![GitHub release](https://img.shields.io/github/v/release/steipete/RepoBar?style=flat-square)](https://github.com/steipete/RepoBar/releases/latest)
[![macOS 15+](https://img.shields.io/badge/macOS-15%2B-000000?style=flat-square&logo=apple)](https://repobar.app/)
[![Swift 6.2](https://img.shields.io/badge/Swift-6.2-F05138?style=flat-square&logo=swift&logoColor=white)](https://www.swift.org/)
[![License](https://img.shields.io/github/license/steipete/RepoBar?style=flat-square)](LICENSE)

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.

![RepoBar showing repository status, local Git state, and an issues submenu](docs/assets/repobar.png)

## Install

Install the Homebrew cask:

```sh
brew install --cask repobar
```

RepoBar requires macOS 15 or newer. A signed app archive is also available from the [latest GitHub release](https://github.com/steipete/RepoBar/releases/latest).

## Quick start

1. Open RepoBar from Applications. Its traffic-light icon appears in the menu bar.
2. Select **Sign in to GitHub** and complete the browser login.
3. Open **Preferences → Repositories** to choose visible, pinned, and hidden repositories.
4. Select a repository in the menu to inspect its issues, pull requests, releases, CI runs, branches, tags, commits, and activity.

That is the complete setup for GitHub.com. Local checkout status and archive-backed offline data are optional.

## 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; visibili