ConfigsApr 11, 2026·1 min read

GitHub CLI (gh) — GitHub Official Command Line Tool

GitHub CLI brings GitHub to your terminal. Create PRs, manage issues, review code, run Actions, browse releases — without leaving the command line. Written in Go and the official cross-platform tool from GitHub.

AI
AI Open Source · Community
Quick Use

Use it first, then decide how deep to go

This block should tell both the user and the agent what to copy, install, and apply first.

# Install
brew install gh                          # macOS
sudo apt install gh                      # Debian/Ubuntu (needs PPA)
winget install GitHub.cli                # Windows

# Auth
gh auth login

Common commands:

gh repo create my-app --public --source=. --push
gh pr create --title "Add feature" --body "Description"
gh pr list
gh pr view 42 --web
gh pr checkout 42
gh pr review 42 --approve
gh pr merge 42 --squash --delete-branch

gh issue create --title "Bug" --body "Steps to reproduce"
gh issue list --assignee @me

gh run list                              # Actions runs
gh run view <id>
gh run watch                             # Tail a running workflow

gh release create v1.0.0 --generate-notes
gh gist create file.txt --public
gh api repos/:owner/:repo/stargazers
Intro

GitHub CLI (binary gh) is the official command line tool for GitHub. Written in Go by the GitHub team, it brings issues, pull requests, Actions, releases, gists, and the REST/GraphQL API directly to your terminal. Cross-platform and works with GitHub.com + GitHub Enterprise.

What gh Does

  • Repos — create, clone, fork, view, archive
  • Pull requests — create, checkout, review, merge
  • Issues — create, close, comment, assign, label
  • Actions — list runs, view logs, rerun, watch
  • Releases — create, upload assets, generate notes
  • Gists — create, list, view
  • API passthrough — gh api for any REST/GraphQL endpoint
  • Extensions — install community extensions (gh extension install)
  • Codespaces — create, list, ssh into Codespaces
  • Copilot integration — gh copilot explain / gh copilot suggest

Architecture

Go CLI that hits the GitHub REST + GraphQL APIs. Auth stored via OAuth device flow in keyring. Commands are composable (--json fields | jq). Extensions add new subcommands by installing binaries or scripts into ~/.local/share/gh/extensions.

Self-Hosting

CLI tool. Authenticates to github.com or your GHES instance.

Key Features

  • Full PR workflow
  • Issue management
  • Actions monitoring and rerun
  • Release management
  • Gist creation
  • GraphQL API passthrough
  • Extension system
  • Copilot CLI integration
  • Cross-platform
  • JSON output for scripting

Comparison

Tool Platform Auth Extensions
gh GitHub OAuth Yes
glab GitLab Token Limited
hub GitHub (legacy) Token No
tea Gitea Token No
bitbucket-cli Bitbucket Token No

常见问题 FAQ

Q: hub 和 gh 有啥区别？ A: hub 是旧版第三方 CLI，gh 是 GitHub 官方出品（2020+），功能更全、体验更好。hub 已停止新功能。

Q: 能脚本化吗？ A: 能。gh pr list --json title,url --jq .[].url 输出 JSON，配合 jq 很容易脚本化 CI 任务。

Q: 可以 API 直接调用吗？ A: 可以。gh api /repos/owner/repo/issues 任意 REST endpoint；gh api graphql -f query=... 执行 GraphQL。

来源与致谢 Sources

Discussion

Sign in to join the discussion.
No comments yet. Be the first to share your thoughts.

Related Assets

delta — Syntax-Highlighting Pager for Git Diff and Grep

delta is a syntax-highlighting pager for git, diff, grep, and rg output. Beautiful side-by-side diffs with language-aware highlighting, line numbers, and theming. Drop-in replacement for the default git pager.

AI Open Source

Yazi — Blazing Fast Terminal File Manager in Rust

Yazi is a blazing fast terminal file manager written in Rust, based on async I/O. Preview images and videos in terminal, fuzzy search, batch operations, plugin system, and seamless integration with tools like fzf, zoxide, and rg.

AI Open Source

fd — A Simple Fast User-Friendly Alternative to find

fd is a simple, fast, and user-friendly alternative to the venerable find command. Written in Rust with smart defaults: color output, gitignore-aware, parallel traversal, and intuitive syntax. Used by VS Code, Helix, and many dev tools.

AI Open Source
◈Home🔍Search👤Me