.\" -*- nroff -*-
.TH github-backup 1 "Commands"
github-backup \- backs up data from GitHub
.B github-backup [\fIusername\fP|\fIorganization\fP ...] [options]
is a simple tool you run in a git repository you cloned from
GitHub. It backs up everything GitHub publishes about the repository,
including other branches, tags, forks, issues, comments, wikis,
milestones, pull requests, and watchers.
Alternately, if you pass it the username of a GitHub user, it will check
out, and back up, all that user's repositories, as well as all the
repositories that user is watching. (Also works to pass
the name of an organization using GitHub.)
By default it runs without logging in to GitHub. To log in, set
GITHUB_OAUTH_TOKEN to an oath or personal access token.
However note that logging in only works around API rate limiting; it
does not allow private repositories to be downloaded.
When backing up a user or an organization, this can be used to exclude
backup of a particular repository belonging to the user or organization.
This option can be specified any number of time to exclude more than one
Avoid backing up a repository's forks.
Joey Hess <email@example.com>