GitHub CLI (gh) — Setup and Usage

Purpose

Ensures the GitHub CLI (gh) is available and provides correct usage patterns for AI agents operating in environments where gh may not be pre-installed and where git remotes point to local proxies instead of github.com.

When to Use

• gh command not found or shutil.which("gh") returns None
• Need to interact with GitHub API (issues, PRs, releases, workflows)
• Repository remote does not point to github.com (proxy environments)
• Need authenticated GitHub operations with GITHUB_TOKEN
• Managing GitHub Issues, Projects V2, Milestones, or Labels

Installation

If gh is not installed, run the setup script: