@antony/github-backup

Github Backup

A tool to backup all of your organisation's github repositories.

Features

• Private repositories
• Paginates an entire github organisation, not just the first page!
• Parallel clone (10 streams)
• Intuitive CLI to show progress
• Uses github API v3

Why?

There are a lot of tools out in the wild for the same purpose, but not a single one of them works reliably or paginates a large organisation, so you get the first 50-100 repositories and then you have to edit the code to get more...

Pre-requisites

You need a github token if you want to backup private repositories. it needs repo permissions.

Usage

Just install the package locally and run the binary it provides:

npm i -g @antony/github-backup
github-backup --token <your-token-from-above> --organisation <organisation> --workingDir=./some/path

Where:

• token is your github token (optional)
• organisation is your organisation name
• workingDir is where you want the repositories cloned to. If it does not exist it will be created.