/git-provider-sync

A CLI and CI-friendly tool for mirroring Git Provider repositories to providers and storage.

Primary LanguageGoEuropean Union Public License 1.2EUPL-1.2

Git Provider Sync

Tag EUPL 1.2 REUSE OpenSSF Scorecard OPEN SSF BEST PRACTICES

What can this tool do for you?

Git Provider Sync is a CLI tool that helps you:

  1. Mirror Repositories: Copy your repos between different Git providers.

  2. Batch Clone Repositories: Grab multiple repos and save them where you want.

  3. Archive Repositories: Pack your repos into compressed files for safekeeping.

Where can you use it?

Initially with support for these Git providers:

  • GitHub

  • GitLab

  • Gitea

And you can save your work to:

  • Any of the above Git providers

  • A compressed archive file (tar.gz)

  • A directory on your computer

Getting Started

  1. Check out the Usage Guide for a quick start.

  2. The Installation Guide will get you up and running.

Make Git Provider Sync better?

Here’s how you can contribute:

For developers and architects

If you’re interested in developing, see the Development Guide.

If you’re interested in an architectural view, see the Software Architecture Description (SAD).

What’s next?

Check out our Issues page.

A friendly reminder

Please Note: Git Provider Sync is currently in Alpha. This means:

  • Things might change in breaking ways.

  • Feel free to share ideas on how we can make it better.

  • When using Git Provider Sync, it’s a good idea to:

  • Use tokens with limited write access (never give full permissions).

  • Keep backups of important data, just in case.

Git Provider Sync is slowly getting stable and reliable. But as with any tool, it’s always good to be careful!

Documenting the project journey

I’m writing a log of how this project is becoming useful. Chapters are

  1. From hack to release - reflections

  2. Learning Go as a Java developer

  3. Open Source Practices

  4. Open Source Security

Legal Stuff

Git Provider Sync is licensed under the EUPL 1.2 License.

Most of the non-code bits are under Creative Commons CC0-1.0.

For all the details, check out our LICENSE file and the headers in each file.