Skip to content

Installation

Requirements

RequirementNotes
Node.js20+
giton PATH — required for every command, including doctor
gh (GitHub CLI)on PATH, authenticated (gh auth status) — required for bump, tag, release, clone, prs, and most of doctor
npmon PATH, authenticated (npm whoami) — required only for publish

Run polyrepo doctor to check all of this in one go, once it's installed.

Installation

bash
npm install -g polyrepo-cli

This makes the polyrepo command available everywhere.

Quick start

bash
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 setup is an interactive menu — no config file to write by hand. Everything else reads the same list of repos it produces.