GitHub CLI setup
Prepare to work with remote repositories on GitHub
Signup to GitHub
Sign up for a free GitHub account if you haven’t already. I recommend that you use a permanent, personal email.
Install the GitHub CLI
Let’s install the GitHub CLI, which will make working with remote GitHub repositories easier.
On MacOS
- Install Homebrew if you do not have it already. Run the following in the Terminal and follow the on-screen instructions:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
- Run
brew install ghand follow the on-screen instructions.
On your personal Windows computer
Download and install https://github.com/cli/cli/releases/download/v2.81.0/gh_2.81.0_windows_amd64.msi
On a Lab computer
- Make a directory in your HOME directory named
gh. For example,C:\Users\laymanl\gh - Download and unzip https://github.com/cli/cli/releases/download/v2.81.0/gh_2.81.0_windows_amd64.zip
- Open the new directory. Click until you find the
bindirectory inside. Drag thatbindirectory to theC:\Users\YOUR_ID\gh\directory you created. - Hit the Windows key and search for
user environment variables. Select the programEdit the user environment variables for this account - Click the
Newbutton, thenBrowse - A File Explorer will appear. Navigate inside the
C:\Users\YOUR_ID\gh\bindirectory. Click “Okay”. - Now open a new Terminal window. Run the command
ghand you should see a list of available commands.
Login with the GitHub CLI
Run gh auth login and follow the onscreen instructions to register your computer with GitHub.
- Leave the default options selected in the CLI. You will hit Enter to open a web browser. Sign into GitHub with your GitHub credentials.

- If the browser does not open: manually open a browser to https://github.com/login/device. Sign into GitHub with your GitHub credentials if needed.
- Enter the code shown in the Terminal window.

- Complete the authorization and leave the default options as-is.
Once you have finished, your Terminal and Browser should look like this:
That’s it. We are now ready to work with Git and GitHub.