Installation

Requirements

Requirement	Notes
Node.js	20+
git	on PATH — required for every command, including doctor
gh (GitHub CLI)	on PATH, authenticated (gh auth status) — required for GitHub repos: bump, tag, release, clone, prs, and most of doctor
glab (GitLab CLI)	on PATH, authenticated (glab auth status) — same, for GitLab repos. A self-hosted instance needs its hostname registered via setup first
npm	on PATH, authenticated (npm whoami) — required only for publish

gh/glab are only required for the host(s) your repos are actually on — a GitHub-only setup never needs glab, and vice versa; see Config & Discovery. Run polyrepo doctor to check all of this in one go, once it's installed.

Installation

npm install -g polyrepo-cli

This makes the polyrepo command available everywhere.

Quick start

polyrepo setup      # tell it where your package repos live
polyrepo doctor     # confirm the environment is set up correctly
polyrepo list       # see version/branch/tag/release/npm status for everything
polyrepo ui         # or do all of it in the browser

polyrepo setup is an interactive menu — no config file to write by hand. Everything else reads the same list of repos it produces. polyrepo ui opens the same commands as pages in the browser.