by pearkes

pearkes / gethub

A utility for cloning and fetching your remote git repositories from GitHub.

207 Stars 219 Forks Last release: Not found MIT License 101 Commits 1 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:



Build Status

helps you keep all of your git repositories that have GitHub remotes up to date.


You can download a binary,

, depending on your platform.

To determine your platform:

uname -sm

On Darwin, you can copy the binary to your bin:

cp ~/path/to/gethub /usr/local/bin/

Or, if you have Go installed:

go install

Getting Started

$ gethub authorize

This asks you where you want to clone your repositories as well as creating an OAuth token for future GitHub requests.

The next time you run a

, all of your new repositories will be cloned and your existing repositories will be fetched.

It's useful if you have a lot of repos and may not have an internet connection.

Never leave home without running


Directory Structure

It's opinionated about how you organize your repositories.

├── pearkes
│   ├── gethub
│   ├── tugboat
│   └──
├── mitchellh
│   └── vagrant
├── amadeus
│   └── html7
├── someorg
│   └── bigproject
└── someotherorg
    └── biggerproject

Basically, your repositories will be name-spaced according to who the owner is on GitHub.

Behind the Curtain

$ gethub
  1. Checks to see if the necessary requirements for
    exist, like it's
  2. Makes sure the path to your repositories looks ok.
  3. Clones any repositories that are missing.
  4. Runs
    git fetch
    in repositories that exist.


Configuration is stored in a

file in your home directory. (

Ignored Repositories

Sometimes you don't want to retrieve that gigantic project that someone committed

files to.
repo: icloud, facebook, pearkes/bootstrap
owner: adobe


Check out the contributing guide.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.