cli/docs/install_windows.md
Andy Feller 60af6bcb49 Initial installation doc refactor
These changes work to improve GitHub CLI users experience by bringing:

- clarity between official and unofficial installation methods
- insight into unofficial installation methods
- consistency across supported operating systems
2025-08-07 20:15:46 -04:00

2.6 KiB

Installing gh on Windows

WinGet

The GitHub CLI package is supported by Microsoft with updates powered by microsoft/winget-pkgs

To install:

winget install --id GitHub.cli

To upgrade:

winget upgrade --id GitHub.cli

Note

The Windows installer modifies your PATH. When using Windows Terminal, you will need to open a new window for the changes to take effect. (Simply opening a new tab will not be sufficient.)

Precompiled binaries

GitHub CLI releases contain precompiled exe and msi binaries for 386, amd64 and arm64 architectures.

Community (Unofficial)

Important

The GitHub CLI team does not maintain the following packages or repositories and thus we are unable to provide support for those installation methods.

Chocolatey

The GitHub CLI package is supported by the Chocolatey communty with updates powered by pauby/ChocoPackages

To install:

choco install gh

To upgrade:

choco upgrade gh

Conda

Conda is an open source package management system and environment management system for installing multiple versions of software packages and their dependencies and switching easily between them. It works on Linux, OS X and Windows, and was created for Python programs but can package and distribute any software.

The GitHub CLI package is supported by the Conda community with updates powered by conda-forge/gh-feedstock.

To install:

conda install gh --channel conda-forge

To upgrade:

conda update gh --channel conda-forge

Scoop

To install:

scoop install gh

To upgrade:

scoop update gh

Webi

Webi is a tool that aims to effortlessly install developer tools with easy-to-remember URLs from official builds quickly, without sudo or Admin, without a package manager, and without changing system file permissions.

The GitHub CLI package is supported by the Webi community with updates powered by webinstall/webi-installers.

To install:

curl -sS https://webi.sh/gh \| sh

To upgrade:

webi gh@stable