Getting Started

Basic usage

Navigate to a directory that contains git repositories as subdirectories, then run any rsmultigit command:

cd ~/git/myorg
rsmultigit list-projects

RSMultiGit will automatically discover git repos by looking for directories containing a .git folder. It searches both immediate subdirectories (*) and two levels deep (*/*).

Checking repository status

See which repos have uncommitted changes:

rsmultigit status

Count dirty repos with statistics:

rsmultigit --stats count-dirty

Find repos with untracked files:

rsmultigit --stats untracked

Pulling all repos

rsmultigit pull

Or quietly:

rsmultigit pull --quiet

Searching across repos

Grep for a pattern across all repositories:

rsmultigit grep "TODO"

Show only filenames:

rsmultigit grep --files "TODO"

Building all projects

Run make across all repos:

rsmultigit build-make

Run rsconstruct build on projects that have an rsconstruct.toml:

rsmultigit build-rsconstruct

Filtering projects

Only operate on specific folders:

rsmultigit --folders projectA,projectB status

Use a custom glob pattern:

rsmultigit --glob "python-*" status

Error handling

By default, rsmultigit stops on the first error. To continue through all projects:

rsmultigit --no-stop pull