hub-credential-helper

The hub-credential-helper implements the git credentials API and provides usernames and passwords based on hub configuration files.

Install

Download the a binary release for you platform and place it in your path. For example on OS X:

wget https://github.com/kelseyhightower/hub-credential-helper/releases/download/0.0.1/hub-credential-helper-darwin-amd64-0.0.1.tgz

tar -xvf hub-credential-helper-darwin-amd64-0.0.1.tgz

sudo mv hub-credential-helper /usr/local/bin/

Usage

Generate a personal access GitHub API token.

Create a hub configuration file and store it in the default configuration path:

cat <<EOF > ~/.config/hub
github.com:
  - protocol: https
    user: <github-username>
    oauth_token: <token>
EOF

Set the HUB_CONFIG env var if you plan to store the hub configuration file in a different path.

Configure git to use the hub-credential-helper for the https://github.com URL:

git config --global credential.https://github.com.helper /usr/local/bin/hub-credential-helper

Test hub-credential-helper:

git credential fill

Stdin:

host=github.com
protocol=https

Enter each line followed by a newline at the prompt. End the session with an addition newline.

Stdout:

protocol=https
host=github.com
username=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
password=x-oauth-basic