1.1.0 • Published 4 years ago

@antony/github-backup v1.1.0

Weekly downloads
-
License
MIT
Repository
-
Last release
4 years ago

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.