Skip to content

Latest commit

 

History

History
19 lines (12 loc) · 1.27 KB

README.md

File metadata and controls

19 lines (12 loc) · 1.27 KB
Raw

git-collage CI Crates.io dependency status

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.