# Mast

> Mast is a macOS menu bar app for developers. One click opens a popover that lists every git repo on your machine — current branch, upstream, dirty file count, open PRs, and the listening dev-server port if one exists. Each row has an inline action pill (Open :<port> when a server is live, Start otherwise) and expands to show recent commits, dirty files, and one-click Stash / Discard / Commit / Push. A companion CLI (`mast`) exposes the same data in the terminal.

Mast is v0.9.0, free, macOS 12 Monterey or later, universal binary (Apple Silicon & Intel), ~187 MB DMG. Source on GitHub, no telemetry, no account, no cloud. Author: Leon Houlier. Website: https://usemast.sh/.

## Landing

- [Homepage](https://usemast.sh/): Product overview, hero popover mock, feature grid, CLI demo, install options.
- [GitHub releases (signed DMG)](https://github.com/leonhoulier/mast/releases/latest): Latest notarized release.

## Docs

- [Using Mast — overview](https://usemast.sh/docs.html#overview): Who Mast is for, what it replaces (nothing — it correlates `lsof`, `ps`, `git`, `docker`, `launchctl`).
- [Install](https://usemast.sh/docs.html#install): `brew install --cask mast` or direct DMG download. CLI lives at `Mast.app/Contents/Resources/mast`.
- [Requirements](https://usemast.sh/docs.html#install): macOS 12 Monterey or later, Apple Silicon or Intel, ~187 MB disk, ~135 MB RAM idle.
- [First scan](https://usemast.sh/docs.html#first-scan): One to three second boot, per-scanner cadence 5–30 s when open, 5× slower when hidden, paused on sleep.
- [Popover anatomy](https://usemast.sh/docs.html#popover): 380×600 floating window — header, search, scrollable Repos list, footer.
- [Tabs](https://usemast.sh/docs.html#tabs): Three tabs exist internally (Ports · Repos · System); v0.8 hid the tab bar and landed on Repos as the single surface. Ports and System still scan in the background.
- [Row actions](https://usemast.sh/docs.html#actions): Open, Start, URL, IDE, Logs, Kill, Stash, Discard (arm-fire confirm), Commit, Push, Start/Stop/Restart for services.
- [Keyboard shortcuts](https://usemast.sh/docs.html#shortcuts): `⌘⇧M` opens the popover, `⌘F` focuses search, `⌘R` force-refreshes, `esc` dismisses.
- [Ports surface](https://usemast.sh/docs.html#ports): TCP LISTEN state rows correlated to process and repo via `cwd`.
- [Repos surface](https://usemast.sh/docs.html#repos): Auto-discovered in dev roots (`~/Developer`, `~/Projects`, `~/Code`, `~/src`, `~/repos`, `~/work`, `~/dev`). Branch, upstream, dirty count, time-ago, open PRs, CI status.
- [System surface](https://usemast.sh/docs.html#system): Processes + Docker + Homebrew + Launch Agents, each a collapsible section.
- [VPS](https://usemast.sh/docs.html#vps): Remote hosts over persistent SSH ControlMaster. (Currently not wired to UI; background scanners only.)
- [Companion CLI](https://usemast.sh/docs.html#cli): `mast` prints repos list by default; `mast overview` prints the firehose.
- [CLI verbs reference](https://usemast.sh/docs.html#cli-verbs): `mast`, `mast overview`, `mast stash <repo>`, `mast discard <repo>`, `mast commit <repo> "msg"`, `mast push <repo>`, `mast log <repo>`, `mast refresh`.
- [Privacy](https://usemast.sh/docs.html#privacy): Everything runs locally. No phone-home, no telemetry, no account. GitHub tokens encrypted via macOS `safeStorage`.
- [FAQ](https://usemast.sh/docs.html#faq): Why not Activity Monitor, no root required, battery impact, repo scan roots, Linux support.
- [Troubleshooting](https://usemast.sh/docs.html#troubleshooting): Stuck first-scan, failed Kill, slow VPS scans.

## Optional

- [Source code](https://github.com/leonhoulier/mast): GitHub repository.
- [Changelog](https://github.com/leonhoulier/mast/blob/main/CHANGELOG.md): Per-release notes, 0.3.0.0 onward.
- [Issue tracker](https://github.com/leonhoulier/mast/issues): Bug reports and feature requests.