Installing the command-line executable

Assuming you have Rust/Cargo installed, run this command in a terminal:

cargo install git-collage

It will make the git-collage command available in your PATH if you've allowed the PATH to be modified when installing Rust. cargo uninstall git-collage uninstalls.

Back to the crate overview.

Readme

git-collage

A tool for selectively mirroring Git repositories.

git-collage was created to fill my desire to backup my own Git repos and mirror the parts of 3rd party repos I care about. To this end the key features this tool has are:

Ability to discover repositories (currently only from GitHub, but more can be added easily)
Ability to filter refs that are mirrored, preventing "useless" refs being created locally (e.g. feature branches, GitHub PR merge commits)
Is a single binary that can be scheduled via cron or systemd (personally I did not want to run a service for what is essentially a time scheduled backup job)

Usage

See git-collage --help for syntax and examples for a sample configuration file.

Things to note:

Console output below INFO level may contain sensitive information (e.g. Github tokens).
GitHub tokens must be generated with the repo scope.