repos

Manage multiple Git repositories as a unified workspace from a single repos.list file.

Quick Start

Create a repos.list file in your project directory listing the repositories you want:

myorg/data-curation
myorg/analysis
myorg/documentation

Then run:

repos clone

This clones all listed repositories into the parent directory of your current location.

What else can you do?

Customise repos.list — clone specific branches (owner/repo@branch), use worktrees (@branch-name), set repository visibility (--public/--private), and more. → repos.list reference

IDE integration — generate a VS Code multi-root workspace file (repos workspace) and configure GitHub Codespaces authentication (repos codespace). → VS Code integration

Run a pipeline across all repos — if your repositories contain a run.sh script (or any script you specify), repos run executes it in each one. → Running pipelines

Language Packages

Use repos directly from R or Python — all the same commands, no terminal required.

→ Python package
→ R package

Installation

→ Installation guide