Getting started

Before you install

PR Marmot is a native desktop dashboard for GitHub pull requests. It currently targets macOS and Linux. The prepared binary release is for Apple-silicon macOS, but the first signed and notarized release is still pending. The Homebrew cask is pending too. Linux and Intel Mac users need to build from source, and Linux parity has not been verified in the macOS development environment.

For now, use the source installer below rather than the unsigned release path or a Homebrew command. You will need Git, the latest stable Rust, and the graphics dependencies required by GPUI. The dependency manifests require Rust 1.92 or newer, although the minimum has not been tested.

• macOS: install full Xcode and its Metal Toolchain.
• Linux: provide a working Vulkan stack, fontconfig, xkbcommon, and the usual X11 or Wayland development and runtime libraries.

PR Marmot is MIT-licensed. Read the source and README on GitHub before building if you need platform-specific detail.

Build from source

The supported source installer builds the current project and accepts an initial repository. Replace owner/name with a repository your GitHub account can access:

curl -fsSL https://raw.githubusercontent.com/oliver-kriska/prmarmot/main/install.sh | sh -s -- --from-source --repo owner/name

On macOS, this installs ~/Applications/prmarmot.app. On Linux, it installs the prmarmot binary to ~/.local/bin by default. There are no prebuilt Linux packages yet. If a macOS build reports that metal is missing, install the required component:

xcodebuild -downloadComponent MetalToolchain

Launch PR Marmot from Spotlight or Finder on macOS, or run prmarmot on Linux. Quit an installed copy before rebuilding or replacing it.

Connect GitHub and choose a scope

PR Marmot uses your existing GitHub CLI login. It does not ask you to paste credentials into the app. Authenticate in a terminal:

gh auth login

If gh is missing or unauthenticated, the app opens a setup screen with guidance, a copyable login command, and Retry. Complete the login, then choose Retry.

1. Start with All repositories to see open pull requests involving your resolved GitHub login.
2. Choose one repository from the searchable picker when you want its complete repository-scoped result. The app makes a fresh scoped request rather than filtering the possibly truncated global page.
3. Use Pin for up to 12 repository shortcuts. Pins persist in order and do not fetch in the background.
4. Switch between Involving me (or My PRs for one repository) and Review queue.

You can also choose the initial scope explicitly when launching: use --all-repos or --repo owner/name.

Continue with Workflows, or use the Reference for shortcuts, configuration, and limits.