Find file History
Latest commit f28c0a8 Apr 15, 2016 @cosmosgenius cosmosgenius Moved url to https now redirects to https. So the current function break. Changing it to https fixes the issue.
Failed to load latest commit information. Minor README fixes Feb 15, 2016
_hub Add hub's completion file Dec 15, 2015
github.plugin.zsh Moved url to https Apr 16, 2016


This plugin supports working with GitHub from the command line. It provides a few things:

  • Sets up the hub wrapper and completions for the git command if you have hub installed.
  • Completion for the github Ruby gem.
  • Convenience functions for working with repos and URLs.


  • empty_gh - Creates a new empty repo (with a and pushes it to GitHub
  • new_gh - Initializes an existing directory as a repo and pushes it to GitHub
  • exist_gh - Takes an existing repo and pushes it to GitHub
  • - Shortens a URL using


Hub needs to be installed if you want to use it. On OS X with Homebrew, this can be done with brew install hub. The hub completion definition needs to be added to your $FPATH before initializing OMZ.

The github Ruby gem needs to be installed if you want to use it.


These settings affect github's behavior.

Environment variables


Git configuration options

  • github.user - GitHub username for repo operations

See man hub for more details.

Homebrew installation note

If you have installed hub using Homebrew, its completions may not be on your $FPATH if you are using the system zsh. Homebrew installs zsh completion definitions to /usr/local/share/zsh/site-functions, which will be on $FPATH for the Homebrew-installed zsh, but not for the system zsh. If you want it to work with the system zsh, add this to your ~/.zshrc before it sources

if (( ! ${fpath[(I)/usr/local/share/zsh/site-functions]} )); then