gh completion

Generate shell completion scripts


Generate shell completion scripts for GitHub CLI commands.

When installing GitHub CLI through a package manager, it's possible that no additional shell configuration is necessary to gain completion support. For Homebrew, see

If you need to set up completions manually, follow the instructions below. The exact config file locations might vary based on your system. Make sure to restart your shell before testing whether completions are working.


Add this to your ~/.bash_profile:

eval "$(gh completion -s bash)"


Generate a _gh completion script and put it somewhere in your $fpath:

gh completion -s zsh > /usr/local/share/zsh/site-functions/_gh

Ensure that the following is present in your ~/.zshrc:

autoload -U compinit
compinit -i

Zsh version 5.7 or later is recommended.


Generate a completion script:

gh completion -s fish > ~/.config/fish/completions/
gh completion -s <shell>


  -s, --shell string   Shell type: {bash|zsh|fish|powershell}

Options inherited from parent commands

      --help   Show help for command