Guide

Install the GitHub CLI on macOS for UplinkMesh

Follow these steps on a Mac to install GitHub CLI (`gh`), authenticate your account, and confirm you are ready to sync projects through UplinkMesh.

  1. 1

    Open Terminal on your Mac

    Press +Space to open Spotlight, type Terminal, and press Return. Leave the Terminal window open—the following commands run from here.

  2. 2

    Install Homebrew (skip if already installed)

    Homebrew makes it easy to install the GitHub CLI. If you already use Homebrew, skip to the next step. Otherwise, paste the command below into Terminal and press Return:

    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

    When prompted, enter your Mac user password. Homebrew will install to /opt/homebrew.

  3. 3

    Install the GitHub CLI

    With Homebrew ready, install GitHub CLI by running:

    brew install gh

    After the install finishes, confirm the version:

    gh --version
  4. 4

    Log in and verify access

    Run gh auth login → GitHub.com → HTTPS → “Y” to enable Git operations. Complete the browser flow to authorize access.

    Back in Terminal, check your status with gh auth status and list a repo you have access to:

    gh repo list --limit 1

    Once authenticated, connect GitHub inside UplinkMesh to start syncing releases and secrets.

    Need advanced configuration tips? Review the GitHub CLI reference.

  5. 5

    Sync GitHub inside UplinkMesh

    Open UplinkMesh, navigate to Integrations → GitHub, and click Connect. Because you already authenticated with `gh`, UplinkMesh can request the required scopes and begin pulling repositories, commits, and deploy history immediately.

    Choose which repos to sync, then watch the dashboard populate with commit timelines, deploy metadata, and release controls—no additional terminal commands required.