README.md

    hub is a command line tool that wraps git in order to extend it with extra features and commands that make working with GitHub easier.

    For an official, potentially more user-friendly command-line interface to GitHub, see cli.github.com and this comparison.

    This repository and its issue tracker is not for reporting problems with GitHub.com web interface. If you have a problem with GitHub itself, please contact Support.

    Usage

    $ hub clone rtomayko/tilt
    #=> git clone https://github.com/rtomayko/tilt.git
    
    # or, if you prefer the SSH protocol:
    $ git config --global hub.protocol ssh
    $ hub clone rtomayko/tilt
    #=> git clone git@github.com:rtomayko/tilt.git

    See usage examples or the full reference documentation to see all available commands and flags.

    hub can also be used to make shell scripts that directly interact with the GitHub API.

    hub can be safely aliased as git, so you can type $ git <command> in the shell and have it expanded with hub features.

    Installation

    The hub executable has no dependencies, but since it was designed to wrap git, it's recommended to have at least git 1.7.3 or newer.

    platform manager command to run
    macOS, Linux Homebrew brew install hub
    macOS, Linux Nix nix-env -i hub
    Windows Scoop scoop install hub
    Windows Chocolatey choco install hub
    Fedora Linux DNF sudo dnf install hub
    Arch Linux pacman sudo pacman -S hub
    FreeBSD pkg(8) pkg install hub
    Debian, Ubuntu apt(8) sudo apt install hub
    Ubuntu Snap We do not recommend installing the snap anymore.
    openSUSE Zypper sudo zypper install hub
    Void Linux xbps sudo xbps-install -S hub
    Gentoo Portage sudo emerge dev-vcs/hub
    any conda conda install -c conda-forge hub

    Packages other than Homebrew are community-maintained (thank you!) and they are not guaranteed to match the latest hub release. Check hub version after installing a community package.

    Standalone

    hub can be easily installed as an executable. Download the latest binary for your system and put it anywhere in your executable path.

    GitHub Actions

    hub is ready to be used in your GitHub Actions workflows:

    steps:
    - uses: actions/checkout@v2
    
    - name: List open pull requests
      run: hub pr list
      env:
        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

    Note that the default secrets.GITHUB_TOKEN will only work for API operations scoped to the repository that runs this workflow. If you need to interact with other repositories, generate a Personal Access Token with at least the repo scope and add it to your repository secrets.

    Source

    Prerequisites for building from source are:

    Clone this repository and run make install:

    git clone \
      --config transfer.fsckobjects=false \
      --config receive.fsckobjects=false \
      --config fetch.fsckobjects=false \
      https://github.com/github/hub.git
    
    cd hub
    make install prefix=/usr/local

    Aliasing

    Some hub features feel best when it's aliased as git. This is not dangerous; your normal git commands will all work. hub merely adds some sugar.

    hub alias displays instructions for the current shell. With the -s flag, it outputs a script suitable for eval.

    You should place this command in your .bash_profile or other startup script:

    eval "$(hub alias -s)"

    PowerShell

    If you're using PowerShell, you can set an alias for hub by placing the following in your PowerShell profile (usually ~/Documents/WindowsPowerShell/Microsoft.PowerShell_profile.ps1):

    Set-Alias git hub

    A simple way to do this is to run the following from the PowerShell prompt:

    Add-Content $PROFILE "`nSet-Alias git hub"

    Note: You'll need to restart your PowerShell console in order for the changes to be picked up.

    If your PowerShell profile doesn't exist, you can create it by running the following:

    New-Item -Type file -Force $PROFILE

    Shell tab-completion

    hub repository contains tab-completion scripts for bash, zsh and fish. These scripts complement existing completion scripts that ship with git.

    Meta

    项目简介

    A command-line tool that makes git easier to use with GitHub.

    🚀 Github 镜像仓库 🚀

    源项目地址

    https://github.com/github/hub

    发行版本 60

    hub 2.14.2

    全部发行版

    贡献者 206

    全部贡献者

    开发语言

    • Go 49.4 %
    • Gherkin 39.8 %
    • Shell 5.4 %
    • Ruby 4.2 %
    • Makefile 0.3 %