Skip to content

antony/github-backup

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Github Backup

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

CircleCI JavaScript Style Guide

gh-backup

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.