Git-Sync is a CLI tool designed to help you back up your Git repositories. This tool ensures you have a local copy of your repositories, safeguarding against potential issues such as account bans or data loss.

By using git-sync, you can easily clone and keep your backups in sync with your remote repositories. This tool is designed to be simple to use, with a straightforward configuration file that allows you to specify the repositories you want to back up and where you want to store them.

Video: https://asciinema.org/a/674282

Why git-sync?

Remember when @defunkt GitHub account got banned? Well, he is the co-founder of GitHub so he did get his account un-banned pretty quickly but what if you are not that lucky?

Recently I have seen many developers getting their GitHub account banned and losing access to their repositories. Some may be able to recover their account (but there is delay in that) and some may not be able to recover their account at all. What would you do if you lose access to your repositories? What if GitHub goes down? What if you accidentally delete your repositories? The answer is simple, you should have a backup of your repositories.

git-sync provides a straightforward way to back up all your repositories locally, ensuring you have access to your code whenever you need it. It does this by doing a bare clone of all your repositories in a specified directory so that you can recover your code in case of any unforeseen circumstances as well as the file size of your backups is minimal.

Features ✨

Backup All Repositories: Automatically clone or update all your GitHub repositories to a local directory.

Periodic Sync: Keep your backups in sync with your remote repositories by running git-sync periodically.

Bare Clone: Efficiently back up repositories using bare clones to save space and speed up the process.

Concurrency: Sync multiple repositories concurrently to reduce the time required for backup.

Configuration File: Easily manage your settings through a YAML configuration file.

Custom Backup Directory: Specify the directory where you want to store your repositories.

Multi Platform: Currently this project supports backing up repositories from all major Git hosting services like GitHub, GitLab, and Bitbucket.

Getting Started 🚀

We have a thorough guide on how to set up and get started with git-sync in our documentation.