GitHub CLI（gh）

项目简介

GitHub CLI（命令为 gh）是 GitHub 官方推出的命令行工具。它把 Pull Request、Issue、Release、Actions 等 GitHub 概念搬到终端里，让你在写代码、用 git 的同一个窗口内完成大部分协作操作，不必频繁切换到浏览器。

项目使用 Go 编写，采用 MIT 协议，支持 macOS、Windows、Linux，并兼容 GitHub.com、GitHub Enterprise Cloud 以及受支持的 GitHub Enterprise Server 版本。

核心能力

• Pull Request 全流程：创建、检出、查看 diff、评论、评审与合并。
• Issue 管理：列出、筛选、创建、关闭 Issue，配合标签与指派使用。
• Actions 集成：查看工作流运行状态与日志，必要时重新运行。
• 仓库与 Release：克隆、创建仓库，管理 Release 与产物下载。
• Agent 技能：内置 gh skill 命令，可为编码 Agent 安装驱动 gh 的技能。

# 查看当前分支相关 PR 状态
gh pr status

# 为编码 Agent 安装 gh 技能
gh skill install cli/cli gh --scope user

安装方式

官方为各平台提供了多种安装渠道：

• macOS：Homebrew 或 releases 页面的预编译二进制。
• Linux & Unix：Debian/Ubuntu/Raspberry Pi 的 deb 包，Amazon Linux、CentOS、Fedora、RHEL、openSUSE 等的 rpm 包，或预编译二进制。
• Windows：WinGet 或预编译二进制。
• 源码构建：参考仓库中的 docs/install_source.md。
• GitHub Codespaces：在 devcontainer 配置中加入 ghcr.io/devcontainers/features/github-cli:1 特性即可。
• GitHub Actions：GitHub 托管运行器已预装 gh 并每周更新。

注意：Linux 软件仓库的 PGP 签名密钥轮换自 2026 年 9 月 5 日起生效，若遇到安装或更新问题，可查阅官方公告获取解决方案。

安全与可验证性

自 v2.93.0 起，gh 的发布版本以不可变发布（immutable releases）形式提供；自 v2.50.0 起，发布产物附带构建溯源证明（Build Provenance Attestation），可借助 Sigstore 校验其来源仓库、git 修订与构建流程。已安装 gh 的用户可以直接用 gh at verify 校验新下载的发布包。

与 hub 的区别

hub 曾是社区广泛使用的非官方 GitHub 命令行工具，它更像 git 的代理；而 gh 是独立工具，采用完全不同的设计思路，由 GitHub 官方维护并持续扩展能力。

适用建议

如果你的团队主要使用 GitHub 协作，gh 值得作为基础工具安装；若需要把它接入脚本或 CI 流程，建议先熟悉常用子命令与认证方式，再逐步扩展到自动化场景。