GitHub CLI

No entries match these filters. Clear filters

1. docs update Oct 22, 2026 · issue 116

   GitHub CLI adds opt-in expiring/refreshable tokens via --expiring flag and expiring_credentials config setting, plus --no-refresh and --json on gh auth status⁠︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄⁠

   └──▷ TRY IT
   Sign in with expiring credentials to limit the blast radius of a leaked token — the access tokenaccess tokenA credential that authorizes a client to use a service or API. It usually has limited permissions and a lifetime; anyone holding it may be able to use those permissions. expires within hours and refreshes automatically.
   copy

   $ gh auth login --expiring

   Opt in to expiring credentials globally so every future gh auth login requests them without needing the flag.
   copy

   $ gh config set expiring_credentials enabled

   • Adds --expiring flag to gh auth login to request short-lived access tokensaccess tokensA credential that authorizes a client to use a service or API. It usually has limited permissions and a lifetime; anyone holding it may be able to use those permissions. paired with rotating refresh tokensrefresh tokensA credential used to obtain a new access token without signing in again. It is sent to the authorization service rather than used directly to call the protected API., reducing leaked-token risk (requires GitHub CLI v2.103.0 or later), and adds gh config set expiring_credentials enabled to opt in to expiring credentials for every sign-in without passing --expiring each time.⁠︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄⁠
   • Adds --no-refresh flag to gh auth token to print the current token without triggering a refresh.
   • Adds --json flag to gh auth status for machine-readable output, combinable with --show-token, and adds a --no-refresh flag to gh auth status to report current authentication state without refreshing the token.
   • Adds --expiring flag to gh auth refresh to preserve expiring credentials when changing scopes (otherwise scope changes replace an expiring credential with a non-expiring one).
   • Adds GH_ENTERPRISE_TOKEN environment variable for authenticating to GitHub Enterprise Server in non-interactive and GitHub ActionsGitHub ActionsGitHub's built-in CI/CD system that runs automated workflows triggered by repository events, letting cyber tools automate testing, building, and releasing without managing separate pipeline infrastructure. contexts, and GH_HOST environment variable to set a default host for commands not tied to a specific repository.

   +2 more show less

   • Adds --hostname flag to gh auth setup-git, gh auth token, and gh auth logout to target a single host rather than all authenticated hosts, for configuring the Git credential helper, reading a stored token, or signing out without interactive prompts respectively.
   • Supports configuring GitHub CLI as a Git credential helper via gh auth setup-git, enabling git push and git pull without a separate credential manager.
   • Adds --expiring flag to gh auth login to request short-lived access tokensaccess tokensA credential that authorizes a client to use a service or API. It usually has limited permissions and a lifetime; anyone holding it may be able to use those permissions. paired with rotating refresh tokensrefresh tokensA credential used to obtain a new access token without signing in again. It is sent to the authorization service rather than used directly to call the protected API., reducing leaked-token risk (requires GitHub CLI v2.103.0 or later), and adds gh config set expiring_credentials enabled to opt in to expiring credentials for every sign-in without passing --expiring each time.⁠︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄⁠
   • Adds --no-refresh flag to gh auth token to print the current token without triggering a refresh.
   • Adds GH_ENTERPRISE_TOKEN environment variable for authenticating to GitHub Enterprise Server in non-interactive and GitHub ActionsGitHub ActionsGitHub's built-in CI/CD system that runs automated workflows triggered by repository events, letting cyber tools automate testing, building, and releasing without managing separate pipeline infrastructure. contexts, and GH_HOST environment variable to set a default host for commands not tied to a specific repository.
   • Supports configuring GitHub CLI as a Git credential helper via gh auth setup-git, enabling git push and git pull without a separate credential manager.

   3 more in Everything

2. v2.103.0 Oct 21, 2026 · issue 116

   GitHub CLI v2.103.0 adds expiring auto-refreshing OAuth tokens and a new gh issue artifact command group for managing issue artifacts.⁠︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄⁠

   └──▷ GET THIS VERSION

   copy

   $ git clone --branch v2.103.0 https://github.com/cli/cli.git
   # already have the repo? check out this version:
   $ git checkout v2.103.0

   └──▷ TRY IT
   Enable expiring, auto-refreshing OAuth tokens globally so every future gh auth login uses short-lived credentials without manual re-authentication.
   copy

   $ gh config set expiring_credentials enabled

   Opt in to expiring credentials for a single sign-in and configure git to use gh as the credential helper so expiring tokens are served and refreshed for git operations.
   copy

   $ gh auth login --expiring && gh auth setup-git

   Create a Markdown artifact on issue #142 with an attached image, then list all artifacts on that issue to confirm it was created.
   copy

   $ gh issue artifact create 142 signin-plan.md --attach ./signin-flow.png
   gh issue artifact list 142

   • Adds --expiring flag to gh auth login to sign in with short-lived, auto-refreshing OAuth credentials that rotate without requiring re-authentication.⁠︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄⁠
   • Adds expiring_credentials enabled setting to gh config set to prefer expiring credentials for every sign-in globally.
   • gh auth status now shows whether a credential is refreshable and the relative time until the current access tokenaccess tokenA credential that authorizes a client to use a service or API. It usually has limited permissions and a lifetime; anyone holding it may be able to use those permissions. expires.
   • Adds new gh issue artifact command group with list, view, create, edit, download, and delete subcommands for managing issue artifacts from the CLI (private preview).
   • Adds --attach flag to gh issue artifact create to attach images or video files to Markdown documents.

   +3 more show less

   • Adds --body-file flag to gh issue artifact edit to update a document's content from a file.
   • Adds --restore-version flag to gh issue artifact edit to roll back an artifact to an earlier version.
   • Replaces gh extension browse with a Bubble Tea TUITUIA text-based user interface that runs inside a terminal, using characters and ANSI escape codes to render menus, panes, and widgets without a graphical desktop, letting cyber tools ship rich interactivity with no GUI dependency..
   • Adds --expiring flag to gh auth login to sign in with short-lived, auto-refreshing OAuth credentials that rotate without requiring re-authentication.⁠︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄⁠
   • Adds expiring_credentials enabled setting to gh config set to prefer expiring credentials for every sign-in globally.
   • Adds new gh issue artifact command group with list, view, create, edit, download, and delete subcommands for managing issue artifacts from the CLI (private preview).
   • Adds --attach flag to gh issue artifact create to attach images or video files to Markdown documents.
   • Adds --body-file flag to gh issue artifact edit to update a document's content from a file.

   +1 more show less

   • Adds --restore-version flag to gh issue artifact edit to roll back an artifact to an earlier version.

   2 more in Everything

3. v2.101.0 Sep 15, 2026 · issue 076

   gh auth login and auth refresh now copy OAuth device codes to the clipboard by default; opt out with gh config set clipboard disabled.⁠︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄⁠

   └──▷ GET THIS VERSION

   copy

   $ git clone --branch v2.101.0 https://github.com/cli/cli.git
   # already have the repo? check out this version:
   $ git checkout v2.101.0

   └──▷ TRY IT
   Persistently opt out of automatic clipboard copying of OAuth device codes across all future auth flows.
   copy

   $ gh config set clipboard disabled

4. v2.100.0 Sep 3, 2026 · issue 064

   GitHub CLI v2.100.0 adds per-host api_host config to route API traffic through a gateway and bundles the webhook extension.

   └──▷ GET THIS VERSION

   copy

   $ git clone --branch v2.100.0 https://github.com/cli/cli.git
   # already have the repo? check out this version:
   $ git checkout v2.100.0

   └──▷ TRY IT
   Route all GitHub API traffic through a corporate gateway — useful when your org requires API calls to pass through an inspection or compliance proxy.
   copy

   $ gh config set api_host gh-gateway.example.com --host github.com

   Confirm the gateway is configured correctly before relying on it in CI pipelines.
   copy

   $ gh config get api_host --host github.com

   • Adds api_host config key (set via gh config set api_host <gateway> --host <host>, read via gh config get api_host --host <host>) to route a GitHub host's API traffic through a custom gateway, leaving auth, Git remotes, and browser URLs on the original host.
   • Adds webhook as an official built-in extension.
   • Prints full command help when gh is invoked by a coding agent after command misuse, improving agent-driven workflows.

   3 details in Everything

5. docs update Sep 2, 2026 · issue 062

   GitHub CLI gains --attach flag to upload local images and videos to issues, PRs, and comments from the command line.

   └──▷ TRY IT
   Add a screenshot inline to a PR when opening it, so reviewers see the image rendered without leaving the CLI.
   copy

   $ gh pr create \
     --title "Fix login screen layout" \
     --body-file ./pr-description.md \
     --attach ./screenshots/before.png \
     --attach ./screenshots/after.png

   Attach an image with descriptive alt text to an issue comment for accessibility.
   copy

   $ gh issue comment 42 --attach 'screenshots/error.png#sign-in screen showing authentication error'

   Embed a video player in an issue comment by referencing the local file in the body and attaching it, so GitHub CLI rewrites the path to a rendered player.
   copy

   $ gh issue comment 42 \
     --body-file ./repro-video-body.md \
     --attach ./recordings/repro.mp4

   • Adds --attach flag to gh issue create, gh issue edit, gh issue comment, gh pr create, gh pr edit, and gh pr comment to upload a local image or video to GitHub and embed the resulting URL inline in the body.
   • Supports repeating --attach multiple times in a single command to attach more than one file (attaching the same file twice is not allowed).
   • Supports alt text for images via a # suffix on the file path (e.g. --attach 'PATH/TO/IMAGE#ALT-TEXT'); alt text is not supported on video files.
   • When --attach is combined with --body or --body-file, GitHub CLI rewrites any matching local file references already present in the Markdown body in-place with the uploaded URL, rather than appending a duplicate; works regardless of whether the body comes from --body, --body-file, stdin, or the interactive editor.
   • Requires push access to the repository to attach files.

   5 details in Everything

6. v2.99.0 Sep 1, 2026 · issue 062

   GitHub CLI v2.99.0 adds --attach for uploading images/videos to issues, PRs, and comments, plus worktree support in gh issue develop.

   └──▷ GET THIS VERSION

   copy

   $ git clone --branch v2.99.0 https://github.com/cli/cli.git
   # already have the repo? check out this version:
   $ git checkout v2.99.0

   └──▷ TRY IT
   Create a linked feature branch for an issue and check it out in an isolated worktree, leaving your main checkout untouched.
   copy

   $ gh issue develop 123 --checkout --worktree /path/to/wt-feature

   • Adds repeatable --attach flag to gh issue create, gh issue edit, gh pr create, gh pr edit, gh issue comment, and gh pr comment to upload local images and videos and embed them in the body; supports optional alt-text via path#Alt text syntax, replaces existing local-path references with uploaded URLs, and appends new ones.
   • Extends gh issue develop with a --worktree flag (used alongside --checkout) to create a linked branch and check it out in a new Git worktree without disturbing the current working copy.
   • Outputs text-only spinner output when gh is invoked by a coding agent, improving agent-readable output.

   3 details in Everything

7. advisory CVE-2026-72924 Aug 20, 2026 · issue 128
   • CVE-2026-72924: gh codespace ports forward exposes forwarded services on all network interfaces by default (affects >=v2.28.0)⁠︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄⁠
8. v2.98.0 Aug 20, 2026 · issue 052

   gh v2.98.0 adds worktree checkout for PRs, semantic/hybrid issue search, and sets GH_EXTENSION for extensions.

   └──▷ GET THIS VERSION

   copy

   $ git clone --branch v2.98.0 https://github.com/cli/cli.git
   # already have the repo? check out this version:
   $ git checkout v2.98.0

   └──▷ TRY IT
   Check out a PR into an isolated git worktree to review it without disturbing your current branch.
   copy

   $ gh pr checkout 12 --worktree ../wt-feature

   Run a semantic or hybrid searchhybrid searchCombining keyword search with semantic or vector search. The results use both exact term matches and similarity in meaning. across GitHub issues when keyword search misses intent-based matches.
   copy

   $ gh search issues --search-type semantic 'authentication token expiry'

   • Adds --worktree PATH flag to gh pr checkout to check out a pull request directly into a git worktree.
   • Adds --search-type flag to gh search issues supporting semantic and hybrid search modes.
   • Sets GH_EXTENSION=1 environment variable when gh invokes an extension, allowing extensions to detect they were launched by gh.

   3 details in Everything

9. advisory CVE-2026-64655 Jul 31, 2026 · issue 128
   • CVE-2026-64655: Attestation verification bypass via unescaped regex metacharacters in SAN matching (affects <=2.96.0)⁠︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄⁠
10. advisory CVE-2026-64653 Jul 31, 2026 · issue 128
    • CVE-2026-64653: Unescaped variable components in request URLs could allow path traversal in GitHub CLI (affects <=v2.96.0)⁠︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄⁠
11. advisory CVE-2026-64654 Jul 31, 2026 · issue 128
    • CVE-2026-64654: Terminal escape sequence injection in multiple gh commands (affects <= v2.96.0)⁠︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄⁠
12. v2.97.0 Jul 31, 2026 · issue 031

    gh project commands now support field/option names, plus Grok skill host and Devin agent added.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.97.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.97.0

    └──▷ TRY IT
    Update a project item's Status field by name instead of requiring numeric field/option IDs.
    copy

    $ gh project item-edit 1 --owner monalisa --url <url> --field "Status" --value "In Progress"

    List project items with Status and Priority shown as named columns for quick triage.
    copy

    $ gh project item-list 1 --owner "@me" --field "Status" --field "Priority"

    • Adds name-based field and single-select option resolution to gh project item-edit, so you can set fields like Status to In Progress without knowing internal IDs.
    • Adds --field flag to gh project item-list to display named project fields as extra columns in output.
    • Adds Grok skill host support to gh skill agent integrations.
    • Replaces Windsurf with Devin in the gh skill agent roster.

    4 details in Everything

13. advisory CVE-2026-59831 Jul 2, 2026 · issue 128
    • CVE-2026-59831: Connecting to a malicious Codespace via gh codespace jupyter could allow command execution on the user's computer (CVSSCVSSCommon Vulnerability Scoring System, a method for describing a vulnerability's characteristics and severity. Its score is not the probability that attackers will exploit it. 4.4, affects >= v2.10.0)⁠︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄⁠
14. v2.96.0 Jul 2, 2026 · release notes

    gh release download works on public repos without auth; gh skill supports antigravity-cli and detects more coding agents

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.96.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.96.0

    └──▷ USE IT
    Download release assets from a public repository without needing to log in or set a token.
    shell copy

    gh release download v2.96.0 --repo cli/cli

    • gh release download no longer requires authentication for public repositories.
    • gh skill now supports antigravity-cli and antigravity2.0.
    • gh skill detects additional third-party coding agents.

    3 details in Everything

15. v2.95.0 Jun 17, 2026 · release notes

    Adds gh repo read-file and gh repo read-dir commands to inspect repository contents without cloning.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.95.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.95.0

    └──▷ USE IT
    Read a configuration file from a specific release tag to verify its content without cloning the repository.
    shell copy

    gh repo read-file go.mod --ref v2.94.0 --repo cli/cli

    List all entries in a specific source directory to audit structure for automation.
    shell copy

    gh repo read-dir src --repo cli/cli

    Output repository file metadata as JSON for programmatic processing by an agent or script.
    shell copy

    gh repo read-file README.md --repo cli/cli --json name,size

    • Introduces gh repo read-file to read individual repository files to stdout, disk, or formatted output without cloning.
    • Introduces gh repo read-dir to list directory entries in a repository without cloning.
    • Both new commands support --ref to target specific branches, tags, or commits and --json, --jq, --template for scripting.

    3 details in Everything

16. v2.94.0 Jun 10, 2026 · release notes

    Adds gh discussion command set and Issues 2.0 fields (--type, --parent, --blocked-by) to gh issue.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.94.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.94.0

    └──▷ USE IT
    View the first discussion in a repo along with its full comment thread.
    shell copy

    gh discussion list | head -n 1 | awk '{print $1}' | xargs -I{} gh discussion view {} --comments

    Create a new bug issue on the current repo and link it to an existing blocker.
    shell copy

    gh issue create --title 'UI Crash' --type Bug --blocked-by 100

    List all locally installed gh skills to audit available agent capabilities.
    shell copy

    gh skill list

    • gh discussion list — List discussions
    • gh discussion view <id> --comments — View a discussion with its comments
    • gh discussion create — Create a new discussion
    • gh discussion edit <id> — Edit an existing discussion
    • gh discussion comment <id> — Add a comment to a discussion

    +8 more show less

    • gh discussion comment <url> — Reply to a specific comment via its URL
    • gh issue create --type <Type> — Set the type of a new issue
    • gh issue edit <id> --type <Type> — Change the type of an existing issue
    • gh issue create --parent <parentId> — Link a new issue to a parent
    • gh issue edit <id> --add-sub-issue <subIssueId> — Add a sub-issue link on an existing issue
    • gh issue create --blocked-by <issueId> — Set a blocked by relationship during creation
    • gh issue edit <id> --add-blocking <blockingId> — Set a blocking relationship on an existing issue
    • gh skill list — List installed agent skills

    13 details in Everything

17. advisory CVE-2026-48501 May 27, 2026 · issue 128
    • CVE-2026-48501: Incorrect authorization header in API requests to TUF repository mirrors via gh attestation, gh release verify, and gh release verify-asset commands (CVSSCVSSCommon Vulnerability Scoring System, a method for describing a vulnerability's characteristics and severity. Its score is not the probability that attackers will exploit it. 7.4, affects <= v2.92.0)⁠︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄⁠
18. v2.93.0 May 27, 2026 · release notes

    gh secret set now supports agent secrets for Copilot cloud agents

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.93.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.93.0

19. v2.92.0 Apr 28, 2026 · release notes

    gh skill commands now support GitHub Enterprise Cloud data residency hosts; skill preview gains --allow-hidden-dirs flag

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.92.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.92.0

    • gh skill install, preview, publish, search, and update subcommands now work with GitHub Enterprise Cloud (GHEC) hosts that have data residency constraints.
    • Adds the --allow-hidden-dirs flag to the gh skill preview command, enabling previews of skills located in hidden directories such as .claude/skills/ or .agents/skills/.

    2 details in Everything

20. v2.91.0 Apr 22, 2026 · release notes

    GitHub CLI v2.91 adds pseudonymous telemetry collection and gh skill capabilities for multi-agent support, hidden dir discovery, upstream detection, and a new telemetry command.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.91.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.91.0

    └──▷ USE IT
    View collected telemetry data without leaving the CLI.
    shell copy

    gh telemetry

    Install a skill located in a hidden dot-directory that standard discovery might skip.
    shell copy

    gh skill install --allow-hidden-dirs .claude/skills/myskill

    Force installation from the detected upstream source for a re-published skill in a script.
    shell copy

    gh skill install --upstream my-repo/skill-package

    • gh telemetry subcommand added to manage or inspect collected telemetry data
    • Adds --allow-hidden-dirs flag to gh skill install to discover skills in dot-prefixed directories like .claude/skills/ and .agents/skills/
    • Adds --upstream flag to gh skill install to support non-interactive installation of skills detected as re-published from an upstream source

    3 details in Everything

21. v2.90.0 Apr 16, 2026 · release notes

    New gh skill command group for managing AI agent skills, plus unauthenticated extension installs and smart suggestions

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.90.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.90.0

    └──▷ USE IT
    Discover AI skills for Copilot related to security directly from the terminal.
    shell copy

    gh skill search copilot security

    Publish a new skill after validating it locally without pushing remote state yet.
    shell copy

    gh skill publish --dry-run

    • Adds the new gh skill command group with subcommands: search, preview, install, update, and publish to manage portable agent skills from the CLI.
    • Adds --pin <version> flag to gh skill install to pin a specific version of an agent skill instead of using the default latest release.
    • Adds --agent and --scope flags to gh skill commands to target a specific AI coding agent (e.g., Copilot, Claude Code) and scope during discovery or installation.
    • Enables gh extension install without requiring authentication when installing public extensions that do not need auth to access their release assets.
    • Adds smart suggestions for official extensions (like gh stack) when running an unknown command, prompting the user to install the matching official extension.

    5 details in Everything

22. v2.89.0 Mar 26, 2026 · release notes

    gh agent-task supports ghe.com; new TUITUIA text-based user interface that runs inside a terminal, using characters and ANSI escape codes to render menus, panes, and widgets without a graphical desktop, letting cyber tools ship rich interactivity with no GUI dependency. prompter behind GH_EXPERIMENTAL_PROMPTER; search-based assignee selection on gh pr/issue create/edit

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.89.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.89.0

    └──▷ USE IT
    Enable the experimental TUI prompter for interactive commands.
    shell copy

    export GH_EXPERIMENTAL_PROMPTER=1
    gh issue create --title 'New bug'

    Create a PR and select an assignee via search on github.com.
    shell copy

    gh pr create --assignee '@search:john' --title 'Fix typo'

    • Adds experimental TUI prompter via GH_EXPERIMENTAL_PROMPTER=1 using charmbracelet/huh.
    • gh pr create, gh issue create, and gh issue edit now support search-based assignee selection on github.com.

    2 details in Everything

23. v2.88.0 Mar 10, 2026 · release notes

    GitHub CLI v2.88.0 adds Copilot Code Review via gh pr, gh issue close --duplicate-of, and JSON support for gh agent-task

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.88.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.88.0

    └──▷ TRY IT
    Request an automated Copilot review on a new PR or existing PR
    copy

    $ gh pr create --reviewer @copilot
    gh pr edit <pr-number> --add-reviewer @copilot

    Close an issue as a duplicate of another issue via the CLI
    copy

    $ gh issue close 123 --duplicate-of 456
    gh issue close 789 --reason duplicate

    • gh pr create and gh pr edit now support requesting review from Copilot Code Review using the --add-reviewer @copilot flag
    • gh issue close gains --duplicate-of flag to link a closed issue to another issue, and supports --reason duplicate
    • gh agent-task list and gh agent-task view support --json, --jq, and --template flags for programmatic output
    • gh pr diff adds --exclude flag to filter files from diff output
    • gh pr view/list adds changeType field to files JSON output

    +3 more show less

    • gh repo clone supports new --no-upstream flag
    • gh repo edit gains --squash-merge-commit-message flag
    • gh browse supports new --blame flag

    8 details in Everything

24. v2.87.0 Feb 18, 2026 · release notes

    gh pr edit adds --add-reviewer @copilot flag and project item-list gets --query

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.87.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.87.0

    └──▷ USE IT
    Request an AI code review for a pull request via CLI.
    shell copy

    gh pr edit <PR_NUMBER> --add-reviewer @copilot

    • Adds --add-reviewer @copilot flag to gh pr edit to request a Copilot Code Review
    • Adds --query flag to gh project item-list for filtering items
    • gh workflow run now immediately prints the created workflow run URL

    3 details in Everything

25. v2.86.0 Jan 21, 2026 · release notes

    Adds gh copilot subcommand to install and run the GitHub Copilot CLI, plus improvements to gh cache delete

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.86.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.86.0

    • Adds gh copilot subcommand to install and execute the GitHub Copilot CLI agent.
    • gh cache delete now supports deleting all caches for a specific ref.

    2 details in Everything

26. v2.85.0 Jan 14, 2026 · release notes

    gh browse adds --actions flag; gh repo set-default accepts git remote names

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.85.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.85.0

    └──▷ TRY IT
    Open the repository's Actions tab from the terminal for a specific org/repo.
    copy

    $ gh browse --actions

    Set the default remote (e.g., upstream) as the repo for subsequent commands like gh browse.
    copy

    $ gh repo set-default upstream

    • Adds --actions flag to gh browse to open the Actions tab in a browser.
    • Allows gh repo set-default to accept git remote names instead of just URLs.

    2 details in Everything

27. v2.83.0 Nov 4, 2025 · release notes

    New gh pr revert command and --custom-agent flag for gh agent-task create.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.83.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.83.0

    └──▷ USE IT
    Create an agent task using a custom agent definition instead of the default.
    shell copy

    gh agent-task create --custom-agent "my-custom-agent"

    Filter release list JSON for immutability status using standard tools.
    shell copy

    gh release list --json name,isImmutable

    Revert a specific pull request by its ID.
    shell copy

    gh pr revert <PR_ID>

    • gh agent-task create now accepts the --custom-agent/-a flag to specify a custom agent.
    • Adds isImmutable field to the JSON output of release list.
    • Introduces the gh pr revert subcommand for reverting pull requests.

    3 details in Everything

28. v2.81.0 Oct 1, 2025 · release notes

    Adds gh release verify and release verify-asset commands plus --json flag to gh auth status

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.81.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.81.0

    └──▷ USE IT
    Verify an asset from the latest release has a valid attestation.
    shell copy

    gh release verify-asset my-asset.zip

    Get gh auth status output as JSON for programmatic consumption.
    shell copy

    gh auth status --json type,login

    • release verify and release verify-asset are now visible
    • Add JSON output to gh auth status

    2 details in Everything

29. v2.80.0 Sep 23, 2025 · release notes

    GitHub CLI v2.80 adds gh agent-task commandset for managing coding agent tasks.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.80.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.80.0

    └──▷ HOW TO FIND IT
    Kick off a new coding agent task from the terminal.
    📍gh agent-task create refactor the codebase
    Watch the logs of an active agent task in real-time.
    📍gh agent-task view 1234 --log --follow
    • gh agent-task create <message>
    • gh agent-task list
    • gh agent-task view <id> [--log] [--follow]

    3 details in Everything

30. v2.79.0 Sep 9, 2025 · release notes

    Adds advanced issue search queries to gh search and --search flags; adds --clipboard/-c flag for OAuth copy on gh auth login/refresh; adds --ref to gh cache delete.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.79.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.79.0

    └──▷ USE IT
    Delete a cache for a specific branch using the new --ref flag.
    shell copy

    gh cache delete --ref main

    Automatically copy the OAuth code to the clipboard during login.
    shell copy

    gh auth login --clipboard

    Search for open pull requests with specific labels using advanced query syntax.
    shell copy

    gh search prs --search 'is:open label:bug'

    • Adds --ref option to gh cache delete to target a specific branch or tag when removing caches
    • Adds --clipboard (-c) flag to gh auth login and gh auth refresh to automatically copy the OAuth one-time pass code to the clipboard
    • Adds advanced issue search query support via --search flag in gh search issues, gh search prs, gh issue list, and gh pr list

    3 details in Everything

31. v2.78.0 Aug 21, 2025 · release notes

    Adds --force flag to gh run cancel to skip interactive confirmation.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.78.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.78.0

    └──▷ USE IT
    Force-cancel the current run in CI without waiting for confirmation.
    shell copy

    gh run cancel --force

    • gh run cancel now accepts a --force flag to bypass the interactive prompt.

    1 detail in Everything

32. v2.77.0 Aug 21, 2025 · release notes

    gh issue view and gh pr view now display v2 projects

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.77.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.77.0

    • gh issue view displays GitHub Project (v2) data in its output
    • gh pr view displays GitHub Project (v2) data in its output

    2 details in Everything

33. v2.76.0 Jul 17, 2025 · release notes

    Adds gh issue create --assignee @copilot to assign issues to the Copilot coding agent

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.76.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.76.0

    └──▷ TRY IT
    Create an issue and immediately assign it to the GitHub Copilot coding agent.
    copy

    $ gh issue create --title "Bug" --body "Details" --assignee @copilot

34. v2.75.0 Jul 9, 2025 · release notes

    GitHub CLI v2.75.0 adds gh init release, gh init verify and --no-repos-selected to gh secret set

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.75.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.75.0

    • Adds --no-repos-selected flag to gh secret set to handle secret operations when no repository context is active

    1 detail in Everything

35. v2.74.0 May 29, 2025 · release notes

    GitHub CLI v2.74.0 introduces gh preview prompter, adds --compact flag to gh run watch, and updates attestation retry logic.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.74.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.74.0

    └──▷ TRY IT
    Initialize a new workflow setup via an interactive TUITUIA text-based user interface that runs inside a terminal, using characters and ANSI escape codes to render menus, panes, and widgets without a graphical desktop, letting cyber tools ship rich interactivity with no GUI dependency. wizard instead of manually editing YAML.
    copy

    $ gh preview prompter

    Stream GitHub ActionsGitHub ActionsGitHub's built-in CI/CD system that runs automated workflows triggered by repository events, letting cyber tools automate testing, building, and releasing without managing separate pipeline infrastructure. runs in a compact terminal window or SSH session without verbose JSON/detailed logs.
    copy

    $ gh run watch --compact

    • Introduces the preview prompter subcommand for interactive workflow configuration
    • Adds --compact flag to gh run watch to produce terse, line-drawing output suitable for constrained terminals
    • Enhances gh attestation commands with retry logic when fetching Trusted Uniform Format (TUF) content to improve reliability

    3 details in Everything

36. v2.73.0 May 19, 2025 · release notes

    GitHub CLI v2.73.0 adds @copilot assignee support and last comment deletion for issues/PRs

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.73.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.73.0

    └──▷ TRY IT
    Assign the Copilot coding agent to issue #42 using gh issue edit.
    copy

    $ gh issue edit 42 --add-assignee @copilot

    Assign the Copilot coding agent to pull request #10 using gh pr edit.
    copy

    $ gh pr edit 10 --add-assignee @copilot

    • gh issue edit supports --add-assignee @copilot to assign the GitHub Copilot coding agent to an issue.
    • gh pr edit supports --add-assignee @copilot to assign the GitHub Copilot coding agent to a pull request.
    • gh issue comment delete and gh pr comment delete support deleting the last comment (identified via a special flag or default behavior implied by last comment delete).
    • JSON output from gh issue view now includes the closedByPullRequestsReferences field.

    4 details in Everything

37. v2.72.0 Apr 30, 2025 · release notes

    Adds gh accessibility help command with non-interactive input and text spinners

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.72.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.72.0

    └──▷ TRY IT
    Explore the new accessible features via CLI help
    copy

    $ gh accessibility

    • gh accessibility help topic introduces customizable contrasting colors, non-interactive user input prompting, and text-based spinners for accessibility.

    1 detail in Everything

38. v2.71.0 Apr 23, 2025 · release notes

    GitHub CLI v2.71.0 adds configurable spinner control and Git @{push} support for PR creation

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.71.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.71.0

    └──▷ USE IT
    Create a PR using the commit that is currently pushed to the remote, avoiding manual ref resolution.
    shell copy

    gh pr create --head @{push}

    • gh pr create now supports Git's @{push} revision syntax for determining the head ref.
    • Introduces option to opt-out of spinners in the CLI.
    • gh config: adds config settings for accessible prompter and disabling spinner.

    3 details in Everything

39. v2.70.0 Apr 15, 2025 · release notes

    Adds --label-colors config key and experimental accessible prompter

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.70.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.70.0

    • Introduces accessible prompter for screen readers (preview)
    • Adds experimental support for rendering markdown with customizable, accessible colors

    2 details in Everything

40. v2.69.0 Mar 19, 2025 · release notes

    CLI commands now expand globs for filepath arguments, enabling broader file selection in a single pass.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.69.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.69.0

    └──▷ USE IT
    Force creation of a new comment on an issue or PR even if no previous comments exist.
    shell copy

    gh pr comment 42 --body "New comment" --edit-last --create-if-none

    • gh issue/pr comment --edit-last gains the --create-if-none flag to create a comment when none exists
    • Commands accepting filepath arguments now support glob expansion for * characters

    2 details in Everything

41. v2.68.0 Mar 5, 2025 · release notes

    New flags for gh attestation verify, gh pr checkout, and gh issue/pr comment; improved gh cache delete --all and gh repo fork.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.68.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.68.0

    └──▷ TRY IT
    Verify an attestation from a specific source commit hash.
    copy

    $ gh attestation verify artifact.tar.gz --source-ref abc123

    Checkout a PR without fetching tags to speed up CI environments.
    copy

    $ gh pr checkout 42 --no-tags

    Auto-create an issue comment if one doesn't exist, failing silently if no caches are present.
    copy

    $ gh issue comment 1 --body "New update" --create-if-none
    gh cache delete --all --succeed-on-no-caches

    • gh attestation verify now accepts --signer-digest, --source-ref, and --source-digest to validate attestations with specific constraints.
    • gh pr checkout passes the new --no-tags flag to git fetch, skipping tag updates during checkout.
    • gh issue comment and gh pr comment support --create-if-none with interactive prompts to auto-create a comment if none exists on the target resource.
    • gh cache delete --all gains --succeed-on-no-caches to return exit code 0 when no caches are found, preventing pipeline failures in clean states.
    • gh release create now fails if there are no new commits since the last release, preventing empty releases.

    +1 more show less

    • Forking a repo during PR creation (via gh pr create) now automatically updates the default upstream remote.

    6 details in Everything

42. advisory CVE-2025-25204 Feb 14, 2025 · issue 128
    • CVE-2025-25204: gh attestation verify returns incorrect exit code during verification when predicate types mismatch (CVSSCVSSCommon Vulnerability Scoring System, a method for describing a vulnerability's characteristics and severity. Its score is not the probability that attackers will exploit it. 6.3, affects >= v2.49.0)⁠︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄⁠
43. v2.67.0 Feb 11, 2025 · release notes

    gh pr checkout prompts for interactive PR selection; gh repo delete adds autolink support

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.67.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.67.0

    • gh pr checkout now prompts interactively to select a pull request when no ID or branch is provided

    1 detail in Everything

44. v2.66.0 Jan 30, 2025 · release notes

    gh pr view/status support triangular remotes, secret commands require disambiguation, new autolink commands, MSI arm64

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.66.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.66.0

    └──▷ USE IT
    Manage secrets in a forked repo where upstream is the default remote by explicitly specifying the target.
    shell copy

    gh secret set MY_SECRET -b 'value' -R my-fork/my-repo

    Suppress noisy extension update notifications in CI or scripts.
    shell copy

    GH_NO_EXTENSION_UPDATE_NOTIFIER=1 gh extension upgrade

    • gh pr view and gh pr status now respect branch.<branchName>.pushremote, remote.pushDefault configs and the @{push} revision syntax to work in triangular workflows.
    • gh secret list, gh secret set, and gh secret delete now require explicit repository selection via -R, --repo when multiple git remotes are present.
    • Extension update notices can be disabled globally by setting the GH_NO_EXTENSION_UPDATE_NOTIFIER environment variable.
    • Windows MSI installers now support the arm64 architecture, enabled via new build targets.

    4 details in Everything

    └──▷ BREAKING ON UPGRADE

    • !gh secret list, gh secret set, and gh secret delete will fail with an ambiguity error if multiple remotes are configured and -R, --repo is not explicitly provided.
45. v2.65.0 Jan 6, 2025 · release notes

    Adds gh repo edit security_and_analysis flag and gh run list pending status support in v2.65.0

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.65.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.65.0

    └──▷ TRY IT
    Enable secret scanningsecret scanningChecking files, code or other data for exposed credentials such as passwords, API keys and tokens. Findings help teams remove the secret and revoke or rotate it. and code security analysis on an existing repository via CLI.
    copy

    $ gh repo edit <repo> --security-and-analysis=secret_scanning,code_security

    List workflow runs including those that are queued or pending execution.
    copy

    $ gh run list --json status | jq -r '.[] | select(.status == "pending") | .head_branch'

    • gh repo edit now accepts the --security-and-analysis flag to configure repository security settings.
    • gh run list displays a pending state for workflow runs that have not yet started.

    2 details in Everything

46. v2.64.0 Dec 20, 2024 · release notes

    gh pr merge adds --delete-branch support for merge queues; gh attestation verify gains --bundle-from-oci flag and policy print

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.64.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.64.0

    └──▷ TRY IT
    Verify an attestation by fetching the bundle directly from an OCIOCIOpen Container Initiative standard, maintained by the Linux Foundation, defining the image format and runtime spec that container tools share so images built once run anywhere OCI-compliant. registry instead of OIDCOIDCOpenID Connect, a sign-in protocol built on OAuth 2.0. An application uses identity information from a trusted provider instead of maintaining a separate password for each user. metadata
    copy

    $ gh attestation verify --bundle-from-oci oci://registry.example.io/attestations:latest ./sigstore

    • gh pr merge --delete-branch now correctly handles merges requested via a merge queue instead of exiting with an error
    • gh attestation verify prints policy information before performing verification

    2 details in Everything

47. advisory CVE-2024-54132 Dec 3, 2024 · issue 128
    • CVE-2024-54132: Downloading malicious GitHub ActionsGitHub ActionsGitHub's built-in CI/CD system that runs automated workflows triggered by repository events, letting cyber tools automate testing, building, and releasing without managing separate pipeline infrastructure. workflow artifact results in path traversal vulnerability (affects <= 2.63.0)⁠︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄⁠
48. advisory CVE-2024-53858 Nov 27, 2024 · issue 128
    • CVE-2024-53858: Recursive repository cloning can leak authentication tokens to non-GitHub submodule hosts (CVSSCVSSCommon Vulnerability Scoring System, a method for describing a vulnerability's characteristics and severity. Its score is not the probability that attackers will exploit it. 6.5, affects <= 2.62.0)⁠︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄⁠
49. v2.63.0 Nov 27, 2024 · release notes

    GitHub CLI v2.63.0 adds baseRefOid to pr view and bare repo creation support

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.63.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.63.0

    └──▷ USE IT
    Retrieve the base branch OID for a pull request to use in subsequent CI/CD steps or API calls
    shell copy

    gh pr view --json baseRefOid | jq -r '.baseRefOid'

    • Adds baseRefOid output field to pr view command for retrieving the base branch commit reference
    • Enables creation of repositories without an initial commit via bare repo support in repo create

    2 details in Everything

50. v2.62.0 Nov 14, 2024 · release notes

    GitHub CLI v2.62.0 adds notifications for extension upgrades and shortens update checks.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.62.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.62.0

    • Notifies users when a new version of an installed gh extension is available
    • Shortens extension release checking timeout from 3s to 1s

    2 details in Everything

51. v2.61.0 Nov 7, 2024 · release notes

    New --accept-visibility-change-consequences flag for non-interactive visibility updates

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.61.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.61.0

    └──▷ USE IT
    Force a visibility change to public in a CI environment without requiring manual confirmation.
    shell copy

    gh repo edit my-repo --visibility public --accept-visibility-change-consequences

    • Displays repository star and watcher counts in the interactive gh repo edit prompt when changing visibility

    1 detail in Everything

52. v2.59.0 Oct 16, 2024 · release notes

    gh repo license/gitignore list/view subcommands and gist list filtering

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.59.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.59.0

    └──▷ USE IT
    List all gitignore templates available on GitHub directly from the terminal
    shell copy

    gh repo gitignore list

    Filter gists by language to find specific code snippets
    shell copy

    gh gist list --language python

    • Adds repo license list and repo gitignore list subcommands to view available licenses and gitignores
    • Adds filtering support to the gist list command
    • Makes markdown WithWrap() max width configurable

    3 details in Everything

53. v2.57.0 Sep 16, 2024 · release notes

    Adds --active flag to gh auth status, tenancy-aware attestation commands, and API subdomain support for tenant hosts.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.57.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.57.0

    └──▷ TRY IT
    Display only active (non-expired) authentication tokens to quickly audit session state.
    copy

    $ gh auth status --active

    • gh attestation verify now supports custom OIDCOIDCOpenID Connect, a sign-in protocol built on OAuth 2.0. An application uses identity information from a trusted provider instead of maintaining a separate password for each user. issuers for verifying attestations from non-default identity providersidentity providersA service that authenticates users and supplies identity information to other applications. It is the sign-in authority behind many single sign-on systems..
    • gh auth status accepts a new --active flag to filter output and show only active authentication sessions.

    2 details in Everything

54. v2.56.0 Sep 9, 2024 · release notes

    gh attestation verify gains OCIOCIOpen Container Initiative standard, maintained by the Linux Foundation, defining the image format and runtime spec that container tools share so images built once run anywhere OCI-compliant. bundle fetching and offline verification support

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.56.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.56.0

    • Fetches the attestation bundle from an OCI registry for gh attestation verify

    1 detail in Everything

55. v2.55.0 Aug 20, 2024 · release notes

    gh pr create adds --editor flag, gh attestation requires Sigstore Bundle v0.2+, and gh search project flags change format.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.55.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.55.0

    └──▷ USE IT
    Edit a PR's title and body in your configured $EDITOR instead of using interactive prompts
    shell copy

    gh pr create --editor -b "<body_text>"

    • Adds --editor flag to gh pr create to launch an external editor for the PR title and body
    • Requires Sigstore Bundle format version 0.2+ when verifying attestation bundles with gh attestation verify
    • Changes gh search project filter syntax from --project <number> to --project owner/number

    3 details in Everything

56. v2.54.0 Aug 1, 2024 · release notes

    GitHub CLI v2.54.0 adds --remove-milestone, json field exposures for releases/PRs, and --bare clone support.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.54.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.54.0

    └──▷ TRY IT
    Remove a milestone from an issue or PR using the new flag.
    copy

    $ gh pr edit <PR_NUMBER> --remove-milestone <MILESTONE_NAME>

    Retrieve the fullDatabaseId of a pull request for scripting or integration.
    copy

    $ gh pr view <PR_NUMBER> --json fullDatabaseId

    Retrieve the databaseId of a release using JSON output.
    copy

    $ gh release view <TAG> --json databaseId

    • Add --remove-milestone flag to gh issue edit and gh pr edit commands
    • Expose databaseId JSON field for release commands (e.g., gh release view --json databaseId)
    • Expose fullDatabaseId JSON field for PR JSON export (e.g., gh pr view --json fullDatabaseId)
    • Add --bare support to clone targets in gh repo clone

    4 details in Everything

    └──▷ BREAKING ON UPGRADE

    • !The CLI now exits with code 1 (instead of the previous exit code) on authentication issues.
57. v2.53.0 Jul 17, 2024 · release notes

    New attestation subcommand, pr update-branch, and issue create --editor.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.53.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.53.0

    └──▷ TRY IT
    Retrieve repository variables in JSON format for scripting.
    copy

    $ gh variable get MY_VAR --json value,repo

    Create an issue with a custom editor for long descriptions.
    copy

    $ gh issue create --editor

    • Adds attestation trusted-root subcommand for managing attestation trust roots
    • Adds --json option to variable get command for machine-readable output
    • Adds pr update-branch command to update pull request branches
    • Adds issue create --editor flag to open the system editor for issue creation

    4 details in Everything

58. v2.52.0 Jun 24, 2024 · release notes

    Adds -a flag to gh run list to include attached artifacts in output.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.52.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.52.0

    └──▷ USE IT
    List workflow runs along with their attached artifacts for quick review.
    shell copy

    gh run list -a

    • gh run list now accepts the new -a flag to include artifact attachments in the command output.

    1 detail in Everything

59. v2.51.0 Jun 13, 2024 · release notes

    gh attestation verify gains --signer-repo and --signer-workflow flags

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.51.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.51.0

    └──▷ USE IT
    Verify an artifact's provenanceprovenanceEvidence recording where a software artifact came from and how it was built, including its source and build process. It helps a consumer check that the artifact matches a trusted build. only if it was signed by a specific GitHub ActionsGitHub ActionsGitHub's built-in CI/CD system that runs automated workflows triggered by repository events, letting cyber tools automate testing, building, and releasing without managing separate pipeline infrastructure. workflow run.
    shell copy

    gh attestation verify <artifact> --signer-repo octo-org/octo-app --signer-workflow .github/workflows/sign.yml

    └──▷ BREAKING ON UPGRADE

    • !The --json-result flag is replaced by --format=json in gh attestation; using --json-result will now fail.
60. v2.50.0 May 29, 2024 · release notes

    New gh variable subcommand to manage env variables; gh pr checks now supports JSON output

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.50.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.50.0

    └──▷ USE IT
    Retrieve the value of a specific repository environment variable.
    shell copy

    gh variable get MY_VAR

    • Add a gh variable get FOO command to manage repository or organization environment variables directly from the CLI.
    • feat: add json output for gh pr checks by adding --json flag support to retrieve check run details in structured format.

    2 details in Everything

    └──▷ BREAKING ON UPGRADE

    • !The Attempts field is renamed to Attempt; expose in gh run view and gh run ls affecting JSON output consumers.
61. v2.49.0 Apr 30, 2024 · release notes

    Adds the gh attestation command set for downloading and verifying artifact attestations.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.49.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.49.0

    └──▷ USE IT
    Verify the provenanceprovenanceEvidence recording where a software artifact came from and how it was built, including its source and build process. It helps a consumer check that the artifact matches a trusted build. of an OCIOCIOpen Container Initiative standard, maintained by the Linux Foundation, defining the image format and runtime spec that container tools share so images built once run anywhere OCI-compliant. image stored in GitHub Container Registry before use.
    shell copy

    gh attestation verify oci://ghcr.io/foo/bar:latest -o <your org>

    Download the attestation bundle for a specific artifact to inspect its signed metadata locally.
    shell copy

    gh attestation download artifact.bin -o <your org>

    • Introduces the gh attestation verify command to check integrity and provenance of artifacts, including local files and OCI images (oci://...).
    • Adds gh attestation download to retrieve cryptographically signed metadata (attestations) for built artifacts.
    • Enables offline verification mode via a dedicated offline path for gh attestation verify.

    3 details in Everything

62. v2.48.0 Apr 17, 2024 · release notes

    gh auth login gains --skip-ssh-key flag; gh api supports --slurp and nested arrays.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.48.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.48.0

    • Added --skip-ssh-key option to gh auth login command
    • Added support for --slurping JSON responses in gh api
    • Added numSelectedRepos to JSON output of gh secret list
    • Added support for multiple items in gh api nested array

    4 details in Everything

63. v2.47.0 Apr 3, 2024 · release notes

    Introduces gh-attestation subcommand for inspecting software supply chainsoftware supply chainThe dependencies, tools and processes used to build and deliver software. Compromising one part can affect the products or organizations that rely on it. attestation metadata.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.47.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.47.0

    └──▷ USE IT
    Inspect attestation data for a specific release artifact.
    shell copy

    gh-attestation view --repo github/cli/cli

    • Adds gh-attestation command to view artifact attestations.
    • Upgrades the project to Go 1.22.

    2 details in Everything

64. v2.46.0 Mar 20, 2024 · release notes

    Adds --dry-run to gh pr create and includes draft issue IDs in project item-list output

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.46.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.46.0

    └──▷ USE IT
    Test a pull request creation without actually pushing it to GitHub.
    shell copy

    gh pr create --title "WIP" --body "Draft" --dry-run

    • Adds --dry-run flag to gh pr create for safety checks before pushing.
    • project item-list output now includes draft issue IDs in the JSON response.

    2 details in Everything

65. v2.45.0 Mar 4, 2024 · release notes

    Add ref option to gh cache list, support TTY for project view --web, and link projects to repos/teams.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.45.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.45.0

    └──▷ USE IT
    Filter GitHub ActionsGitHub ActionsGitHub's built-in CI/CD system that runs automated workflows triggered by repository events, letting cyber tools automate testing, building, and releasing without managing separate pipeline infrastructure. cache entries by a specific git reference.
    shell copy

    gh cache list --ref main

    Open a project view in the default browser while preserving terminal interactivity.
    shell copy

    gh project view --web <project-id>

    • Adds the --ref flag to gh cache list to filter cached artifacts by branch, tag, or commit reference
    • Supports TTY output for project view --web, allowing interactive terminal interaction when opening project views

    2 details in Everything

66. v2.44.0 Feb 15, 2024 · release notes

    gh release list gains --order flag; gh cache list gets --cache-key option; body autofill improves.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.44.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.44.0

    └──▷ TRY IT
    Sort releases by creation date instead of the default sort order
    copy

    $ gh release list --order asc

    Filter the cached actions artifacts to find one with a specific key
    copy

    $ gh cache list --cache-key <key_name>

    • Adds --order flag to the gh release list command to control sorting order of releases
    • Adds --cache-key option to gh cache list for filtering caches by key
    • Enables auto-filling pull request body when creating PRs via CLI

    3 details in Everything

67. v2.43.0 Jan 31, 2024 · release notes

    Adds --json export flags for gh variable list and release list; new URL output for repo creation

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.43.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.43.0

    └──▷ USE IT
    Export org variables as JSON for parsing in scripts or CI pipelines.
    shell copy

    gh variable list --org my-org --json name,setValue | jq -r '.[] | .name'

    Export releases as JSON to find the latest tag automatically.
    shell copy

    gh release list --json tagName,createdAt | jq -r 'sort_by(.createdAt) | last.tagName'

    Capture the URL of a newly created repo to open it or configure remotes immediately.
    shell copy

    gh repo create my-repo --clone && gh repo view my-repo --json url | jq -r .url

    • Adds --json flag to gh variable list to export variables in structured JSON format
    • Adds --json flag to gh release list to export releases in structured JSON format
    • Outputs the repository URL when creating a new repo via gh repo create

    3 details in Everything

68. v2.42.1 Jan 16, 2024 · release notes

    Adds Webi as an installation option for GitHub CLI

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.42.1 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.42.1

    └──▷ USE IT
    Install the latest GitHub CLI release on your system using the Webi installer script.
    shell copy

    sh -ci "$(wget https://webi.sh/gh -O-)""

    • gh can now be installed via Webi (webi.installs) alongside existing methods.

    1 detail in Everything

69. v2.40.0 Dec 7, 2023 · release notes

    GitHub CLI v2.40.0 introduces multi-account management via new gh auth switch and enhanced gh auth status commands.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.40.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.40.0

    • gh auth login now supports adding multiple accounts for GitHub.com and GitHub Enterprise to the same local host configuration
    • New gh auth switch subcommand allows manual switching between configured accounts for both gh CLI and git operations
    • gh auth status output enhanced to display multiple configured accounts simultaneously
    • Commit SHA filtering added to gh run list command for precise workflow run identification
    • gh pr merge interactive mode now provides more informative output during merge operations

    5 details in Everything

70. v2.39.2 Nov 27, 2023 · release notes

    Adds upstream branch sync capability to gh repo sync

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.39.2 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.39.2

    └──▷ USE IT
    Sync a local feature branch to track its corresponding upstream branch.
    shell copy

    gh repo sync --upstream

71. v2.39.0 Nov 14, 2023 · release notes

    GH CLI v2.39.0 adds project item status to PR/issue exports and a default Accept header for the api command

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.39.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.39.0

    • issue/pr: Include project item status when exporting issues and pull requests
    • api: Set default Accept header when one is not specified

    2 details in Everything

72. v2.38.0 Nov 1, 2023 · release notes

    GitHub CLI v2.38.0 adds select UI for workflow inputs and fixes tables

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.38.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.38.0

    • workflow run now presents a select for choice workflow input types
    • All tables in GitHub CLI output now have headers

    2 details in Everything

73. v2.37.0 Oct 17, 2023 · release notes

    gh repo create now combines --disable-issues/--template and supports interactive template creation; project JSON output no longer includes template field

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.37.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.37.0

    └──▷ USE IT
    Create a repository using a template while simultaneously disabling issues and setting a homepage URL.
    shell copy

    gh repo create my-new-repo --template=octocat/Hello-World --disable-issues --homepage=https://example.com

    • repo create: Allow --homepage and --template flag to be used together
    • repo create: Allow creating repositories from templates in interactive mode
    • codespace create: Poll permission acceptance endpoint on codespace creation
    • project: Remove template field from --format=json output
    • repo fork: Set default repo when forking repo

    5 details in Everything

    └──▷ BREAKING ON UPGRADE

    • !The template field is removed from the JSON output (--format=json) of project commands
74. v2.36.0 Oct 3, 2023 · release notes

    New codespace port forwarding via Dev Tunnels, JSON export for cache/secret/deploy-key lists, and a clear flag for project item-edit

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.36.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.36.0

    • codespace ports: Forward codespace ports over Dev Tunnels
    • cache list / secret list / deploy-key list: Add support for standard output format flags (e.g. JSON)
    • project item-edit: New --clear flag to remove item field value

    3 details in Everything

75. v2.35.0 Sep 19, 2023 · release notes

    gh alias delete --all and new release flags (--cleanup-tag, --notes-from-tag)

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.35.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.35.0

    └──▷ USE IT
    Remove all local CLI aliases in one command instead of looping through them individually.
    shell copy

    gh alias delete --all

    Create a new release and pull the body text from an existing annotated tag rather than typing it manually.
    shell copy

    gh release create v1.0.0 --notes-from-tag=v1.0.0-pre

    Delete a GitHub release and ensure the corresponding Git tag is also removed remotely.
    shell copy

    gh release delete v1.0.0 --cleanup-tag

    • Adds --all flag to gh alias delete for bulk removal
    • Adds --cleanup-tag flag to gh release delete to automatically remove associated Git tags
    • Adds --notes-from-tag flag to gh release create to populate release notes from an existing tag's description

    3 details in Everything

76. v2.34.0 Sep 6, 2023 · release notes

    GitHub CLI v2.34.0 adds config clear-cache command, --verbose to api, and structured outputstructured outputForcing a model's response to match a given format or JSON schema, so software can parse it reliably instead of hoping the text is well formed. flags to workflow list.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.34.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.34.0

    └──▷ USE IT
    Clear stored authentication and cache data when troubleshooting login issues.
    shell copy

    gh config clear-cache

    Use the new verbose flag to debug API response headers or body during scripting.
    shell copy

    gh api --verbose /repos/{owner}/{repo}/issues

    Extract workflow names from a JSON output using jq for further processing in CI/CD.
    shell copy

    gh workflow list --json name | jq -r '.[].name'

    • config clear-cache: New subcommand to clear the CLI cache.
    • api: Adds the --verbose flag for detailed API response logging.
    • workflow list: Adds --json, --jq, and --template flags for structured output.
    • project mark-template: New subcommand to control project template options.

    4 details in Everything

77. v2.33.0 Aug 21, 2023 · release notes

    Adds --clobber flag to gh alias set, new ruleset list aliases, and rs view bypass check

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.33.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.33.0

    └──▷ TRY IT
    Overwrite an existing gh alias in scripts without interactive prompts.
    copy

    $ gh alias set --clobber ll "log -10 --oneline"

    Use the new shorthand alias for listing rulesets without navigating into a repo.
    copy

    $ gh ruleset ls --org my-org

    • Adds the --clobber flag to gh alias set to allow overwriting existing aliases without confirmation.
    • Adds missing ls aliases to list subcommands, enabling gh ruleset ls shorthand syntax.
    • Allows using the --org parameter in lieu of a repo context for rulesets subcommands.

    3 details in Everything

78. v2.32.0 Jul 11, 2023 · release notes

    GitHub CLI v2.32.0 adds gh ruleset, gh cache commands, and new flags for PR/Release workflows

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.32.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.32.0

    └──▷ USE IT
    Check if a hypothetical branch complies with repository rulesets before merging
    shell copy

    gh rs check main
    gh ruleset list
    gh cache list

    Create a pull request where the title is automatically filled from the first commit message
    shell copy

    gh pr create --fill-first
    gh release edit v1.0 --verify-tag

    Start a Codespaces server instance and have the CLI print out the connection details with a randomly assigned port
    shell copy

    gh codespace create --server-port=0

    • Adds gh ruleset command to manage repository rulesets in beta
    • Adds gh cache command to list and delete GitHub ActionsGitHub ActionsGitHub's built-in CI/CD system that runs automated workflows triggered by repository events, letting cyber tools automate testing, building, and releasing without managing separate pipeline infrastructure. caches
    • Adds --fill-first flag to gh pr create to populate the PR title from the commit message
    • Adds --server-port=0 support to Codespaces commands for random port allocation and connection details display
    • Adds --verify-tag option to gh release edit to validate tag existence

    5 details in Everything

79. v2.31.0 Jun 21, 2023 · release notes

    GitHub CLI v2.31.0 adds new project, search code, and cs view commands plus API enhancements.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.31.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.31.0

    └──▷ USE IT
    Execute a code search directly from the terminal.
    shell copy

    gh search code 'fatal error' --limit 10

    Use the new project commands to list or manage projects.
    shell copy

    gh project list

    • project command suite for interacting with GitHub Projects
    • search code command for code search from the CLI
    • api REST pagination outputs a single JSON array

    3 details in Everything

80. v2.30.0 May 30, 2023 · release notes

    GitHub CLI v2.30.0 adds nested aliases and allows gh repo set-default without a repo argument.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.30.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.30.0

    └──▷ USE IT
    Confirm the default repository context is set in your current environment without specifying the repo name.
    shell copy

    gh repo set-default --view

    • repo set-default --view can now be called without a repo argument
    • Support for nested aliases

    2 details in Everything

81. v2.29.0 May 10, 2023 · release notes

    GitHub CLI v2.29.0 adds alias import command and --repo-owner filter for codespaces

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.29.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.29.0

    └──▷ TRY IT
    Filter the list of active GitHub Codespaces to only those owned by a specific user.
    copy

    $ gh codespace list --repo-owner <username>

    Import existing alias definitions into the local GitHub CLI configuration.
    copy

    $ gh alias import < path/to/aliases.yaml

    • codespace: Add capability to filter by --repo-owner
    • pr status: display auto-merge information

    2 details in Everything

82. v2.28.0 Apr 25, 2023 · release notes

    New gh org list command, multi-value owner flag for search, and several new flags for issue, run, codespace, and ssh-key commands

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.28.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.28.0

    └──▷ TRY IT
    List all organizations visible to the current user.
    copy

    $ gh org list

    Search issues across multiple specific owners.
    copy

    $ gh search issues --owner octocat,github --state open

    Create a new codespace and automatically open the browser.
    copy

    $ gh codespace create --web

    • Adds gh org list subcommand to list organizations.
    • issue edit: allows editing multiple issues at the same time.
    • ssh-key: adds ability to manage signing keys in addition to regular SSH keys.
    • search: enables the --owner flag to take multiple values.
    • codespace list and codespace create add a --web flag.

    +2 more show less

    • run list adds --event and --created filters.
    • repo output now includes a visibility JSON field.

    7 details in Everything

    └──▷ BREAKING ON UPGRADE

    • !macOS release archives changed from .tar.gz to .zip format.
83. v2.27.0 Apr 7, 2023 · release notes

    Adds gh run delete command and -R shorthand for --repo in search subcommands

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.27.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.27.0

    └──▷ TRY IT
    Delete a specific workflow run using its ID.
    copy

    $ gh run delete <run-id>

    Search for issues in a specific repo using the new shorthand flag.
    copy

    $ gh issue list -R owner/repo --state open

84. v2.26.0 Apr 4, 2023 · release notes

    gh 2.26.0 adds secure storage defaults and several new flags for workflows, issues, PRs, and gists

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.26.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.26.0

    └──▷ USE IT
    Use a specific template when creating a new PR.
    shell copy

    gh pr create --template bug_report.md

    Stop watching PR checks immediately if the first one fails, useful for fast CI feedback loops.
    shell copy

    gh pr checks --watch --fail-fast

    Inspect the details of a specific workflow run attempt.
    shell copy

    gh run view --attempt 3

    • gh auth login now uses the operating system's credential storage by default; use --insecure-storage to opt out
    • Adds --template flag to gh issue create and gh pr create for specifying issue/PR templates
    • Adds --fail-fast option to gh pr checks --watch to stop watching on the first check failure
    • Allows filtering workflow runs by status via a new flag in gh run list or similar subcommands
    • Adds support for renaming gists directly from the CLI (gh gist rename)

    +1 more show less

    • gh run view gains an --attempt argument to inspect specific workflow run attempts

    6 details in Everything

85. v2.25.0 Mar 20, 2023 · release notes

    Adds gh variable subcommands for managing repository and organization variables, plus a --force flag for extension installs.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.25.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.25.0

    └──▷ USE IT
    Set an environment variable for a specific repository in CI workflows.
    shell copy

    gh variable set MY_VAR --body "value" --repo owner/name

    List all variables available in the current organization context.
    shell copy

    gh variable list --org my-org

    Force an extension installation, overwriting any existing version.
    shell copy

    gh ext install owner/repo --force

    • Adds the variable set, variable list, and variable delete subcommands to manage Repository and Organization variables
    • Adds a --force flag to the ext install command

    2 details in Everything

86. v2.24.0 Mar 8, 2023 · release notes

    GitHub CLI v2.24 adds secure storage via --secure-storage flag, new repo unarchive command, and GH_PATH env var

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.24.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.24.0

    └──▷ USE IT
    Migrate existing credentials to system keyring for enhanced security.
    shell copy

    gh auth refresh --secure-storage

    Override the configuration file location using the new environment variable.
    shell copy

    GH_PATH=/custom/path gh repo list

    • Adds --secure-storage flag to gh auth login and gh auth refresh to store tokens in the system keyring (Keychain on macOS, GNOME Keyring on Linux, Wincred on Windows) instead of plain text config.
    • Adds gh repo unarchive command to unarchive a repository directly from the CLI.
    • Introduces GH_PATH environment variable to override the default configuration directory location.
    • Adds --releases option to gh browse to navigate directly to the releases page.
    • Extends gpg-key add with a --title argument to assign a custom name to the uploaded GPG key.

    5 details in Everything

87. v2.23.0 Feb 8, 2023 · release notes

    GitHub CLI v2.23.0 adds --default-branch-only to repo fork and visibility warnings to repo edit.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.23.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.23.0

88. v2.22.1 Jan 27, 2023 · release notes

    Adds --yes flag to destructive commands and --reviewer completion support in gh v2.22.1

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.22.1 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.22.1

    • Renames the --confirm flag to --yes for various destructive commands, replacing the previous long-form option.

    1 detail in Everything

    └──▷ BREAKING ON UPGRADE

    • !The --confirm flag has been removed; use --yes instead.
89. v2.22.0 Jan 25, 2023 · release notes

    Adds gh search commits, new Projects support for issue/PR commands, and token scope visibility.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.22.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.22.0

    └──▷ USE IT
    Create a PR and assign it to a project, requiring an OAuth scope refresh.
    shell copy

    gh auth refresh -h github.com -s project && gh pr create --project 'MyProject'

    Enable discussions on a repository via the CLI.
    shell copy

    gh repo edit my-repo --enable-discussions

    • Adds the search commits command to enable searching commit history from the CLI
    • Enables --project <name> flag on gh issue create and gh pr create for GitHub Projects (v2) requiring the project OAuth scope
    • Adds --enable-discussions option to gh repo edit to toggle repository discussions
    • Makes gh auth status display the current token's OAuth scopes
    • Causes gh extension create to automatically make the initial git commit

    5 details in Everything

90. v2.21.0 Dec 22, 2022 · release notes

    New gh repo set-default command, nested JSON in gh api, issue/pr lock commands, and new release flags.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.21.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.21.0

    └──▷ TRY IT
    Resolve ambiguity in a workspace with multiple git remotes by explicitly setting the default repository.
    copy

    $ gh repo set-default

    Pass nested JSON structures to an API endpoint using the new bracket syntax for keys and arrays.
    copy

    $ gh api repos/{owner}/{repo}/issues -X POST -f 'head[branch][name]=main' -f 'labels[]=bug'

    Create a release while validating the tag exists and excluding pre-release assets from publication.
    copy

    $ gh release create v1.0.0 --verify-tag --exclude-pre-releases -n 'Release notes'

    • Adds gh repo set-default command to manage default repository selection for multi-remote repos
    • Enables nested JSON parameters in gh api via bracket syntax (e.g., -f 'head[branch][name]=main', -f 'labels[]=bug')
    • Adds issue lock and pr lock subcommands to lock issues and pull requests
    • Adds issue unlock and pr unlock subcommands to unlock issues and pull requests
    • Adds --verify-tag flag to gh release create

    +3 more show less

    • Adds --exclude-pre-releases flag to gh release create
    • Adds --allow-update-branch flag to gh repo edit
    • Allows setting display name in gh codespace create

    8 details in Everything

    └──▷ BREAKING ON UPGRADE

    • !codespace create and other Codespaces commands now require -R for the repo shorthand; -r is deprecated.
91. v2.20.0 Nov 8, 2022 · release notes

    New gh extension browse and search commands for discovering extensions on GitHub.com

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.20.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.20.0

    └──▷ TRY IT
    Discover and install an extension from the GitHub marketplace using the interactive list view.
    copy

    $ gh extension browse

    • Adds gh extension browse to list, filter, and install available extensions via an interactive interface
    • Adds gh extension search to find repositories with the gh-extension topic

    2 details in Everything

92. v2.19.0 Nov 3, 2022 · release notes

    New gh issue develop command, --latest flag for releases, and several new CLI flags and JSON fields

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.19.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.19.0

    └──▷ USE IT
    Create a new release and explicitly set it as the Latest badge on GitHub
    shell copy

    gh release create v1.0.0 --latest --notes "First stable release"

    Manage feature development by creating a branch linked directly to issue #42
    shell copy

    gh issue develop 42 --checkout

    Force upgrade an extension even if it is currently pinned
    shell copy

    gh extension upgrade my-extension --force

    • gh release create now accepts --latest to explicitly mark a release as the latest version
    • Introduces gh issue develop subcommand for managing branches linked to issues
    • gh release download gains --output flag to specify output location for a single asset
    • gh repo list --topic now accepts multiple topics in a single invocation
    • gh codespace rebuild performs incremental rebuilds by default, with --full for complete rebuilds

    +4 more show less

    • gh extension upgrade accepts --force to override the pinned state of extensions
    • gh run list JSON export includes a new number field
    • gh run view JSON export includes a new jobs field
    • gh pr create can now be used from outside a local git repository when -R and -H are specified

    9 details in Everything

93. v2.18.0 Oct 18, 2022 · release notes

    Adds cs rebuild, SSH/GPG key deletion, and flags to pr diff, release delete, and issue/pr comment

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.18.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.18.0

    └──▷ USE IT
    Rebuild an existing Codespace configuration without destroying the machine
    shell copy

    gh cs rebuild

    Delete a specific SSH key from your GitHub account via CLI
    shell copy

    gh ssh-key delete <key-id>

    View the diff of a pull request in the default browser instead of the terminal pager
    shell copy

    gh pr diff <pull-request-number> --web

    • Adds the new cs rebuild subcommand to reconstruct Codespaces
    • Adds the ssh-key delete subcommand to remove SSH keys via CLI
    • Adds the gpg-key delete subcommand to remove GPG keys via CLI
    • Adds --cleanup-tag flag to release delete to remove associated tags
    • Adds --edit-last flag to issue/pr comment for editing the most recent comment

    +1 more show less

    • Adds --web flag to pr diff to open the diff in a browser instead of the terminal

    6 details in Everything

94. v2.17.0 Oct 4, 2022 · release notes

    Adds gh auth token command and merge email flag to PR merging.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.17.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.17.0

    └──▷ TRY IT
    Export your personal access tokenpersonal access tokenA personal access token, a credential used by scripts and integrations instead of a user's password. Its permissions and expiry depend on the service issuing it. for use in scripts or other tools.
    copy

    $ gh auth token

    Merge a pull request while explicitly setting the author email address for the commit.
    copy

    $ gh pr merge --email "user@example.com"

    • gh auth token subcommand added to print the current user's auth token.
    • New --email flag for gh pr merge to set the commit author email.
    • gh pr status now displays merge conflict information.
    • gh gpg-key list output includes a header row.

    4 details in Everything

95. v2.16.1 Sep 26, 2022 · release notes

    GitHub CLI v2.16.1 adds .yaml support for workflows and env var respect in auth/repo commands

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.16.1 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.16.1

    └──▷ USE IT
    Trigger a workflow defined with a .yaml extension without needing to rename it
    shell copy

    gh workflow run my-workflow.yaml --repo owner/repo

    Force auth login to target a self-hosted instance via environment variable
    shell copy

    GH_HOST=github.mycompany.com gh auth login

    • workflow run now recognizes .yaml files in addition to .yml suffixes as valid workflow file names
    • auth login and repo delete now respect the GH_HOST environment variable for host targeting

    2 details in Everything

96. v2.16.0 Sep 21, 2022 · release notes

    GitHub CLI v2.16.0 adds organization Codespaces secrets, pr checks --required, README generation on repo create, and more JSON fields.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.16.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.16.0

    └──▷ USE IT
    Create a new repository and immediately populate it with a README file.
    shell copy

    gh repo create my-new-repo --generate-readme

    Check only the status checks that are marked as required for a specific PR.
    shell copy

    gh pr checks 123 --required

    List workflow runs with detailed titles and workflow names in JSON format for parsing.
    shell copy

    gh run list --json displayTitle,workflowName

    • repo create now supports generating a repository README automatically
    • pr checks adds the --required flag to filter for required status checks
    • issue close supports --reason "not planned" for closing issues with that specific reason
    • run list --json output includes new displayTitle and workflowName fields
    • pr ready gains an --undo option to revert a PR back to draft state

    5 details in Everything

97. v2.15.0 Sep 6, 2022 · release notes

    GitHub CLI v2.15.0 adds issue pin command and new flags for releases and search output

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.15.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.15.0

    └──▷ TRY IT
    Pin a specific issue to the top of its repository's issue list
    copy

    $ gh issue pin 123456789

    Create a new release with notes starting from a specific tag instead of the previous release
    copy

    $ gh release create v2.15.0 --notes-start-tag v2.14.0 "Release notes text"

    • Adds issue pin subcommand to pin issues on a repository
    • Adds --clobber flag to release download to overwrite existing files
    • Adds --skip-existing flag to release download to skip already-downloaded assets
    • Adds --notes-start-tag parameter to release create to define the start of release notes
    • Exposes repository name without owner prefix in search command output

    5 details in Everything

    └──▷ BREAKING ON UPGRADE

    • !The Linux installation GPG signing key has been rotated; existing downloaded keys must be replaced.
98. v2.14.5 Aug 23, 2022 · release notes

    gh pr diff gains --name-only, PR output shows age field, env vars supported in --jq

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.14.5 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.14.5

    └──▷ TRY IT
    Get a concise list of modified files in a PR for quick code review planning without parsing large diffs.
    copy

    $ gh pr diff --name-only

    Run gh commands in automated scripts where interactive prompts would cause hangs or errors.
    copy

    $ GH_PROMPT_DISABLED=1 gh pr list

    • Adds --name-only flag to gh pr diff subcommand to list changed file paths instead of full diffs
    • Enables GH_PROMPT_DISABLED environment variable to disable interactive prompting in the CLI
    • Adds age field to pr list and pr view output for pull request age information
    • Allows use of environmental variables inside --jq expressions on commands that support JSON filtering

    4 details in Everything

99. v2.14.0 Jul 12, 2022 · release notes

    Adds cs list --repo filtering and raises the artifact retrieval limit for run download to over 100.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v2.14.0 https://github.com/cli/cli.git
    # already have the repo? check out this version:
    $ git checkout v2.14.0

    └──▷ TRY IT
    List codespaces in a specific repository instead of the entire organization or user.
    copy

    $ gh cs list --repo <owner>/<repo>

    • Adds a --repo flag to cs list, enabling filtering by repository name
    • Changes the default behavior of run download to allow retrieving more than 100 artifacts

    2 details in Everything

100. v2.13.0 Jun 22, 2022 · release notes

     New pr merge --match-head-commit, codespace org management, and ARMARMA family of RISC processor architectures designed by Arm Holdings and licensed to chip makers worldwide; tools target it to run natively on mobile, embedded, and increasingly server and desktop hardware. binary support in v2.13.0

     └──▷ GET THIS VERSION

     copy

     $ git clone --branch v2.13.0 https://github.com/cli/cli.git
     # already have the repo? check out this version:
     $ git checkout v2.13.0

     └──▷ USE IT
     Merge a PR only if the merge commit matches the head commit exactly, preventing accidental merges on out-of-date branches.
     shell copy

     gh pr merge --merge --match-head-commit <PR_NUMBER>

     Create a codespace that automatically shuts down after 24 hours.
     shell copy

     gh codespace create --retention-period 24h

     List all codespaces owned by a specific organization as an admin.
     shell copy

     gh codespace list --org <ORGANIZATION_NAME>

     • Add --match-head-commit flag to gh pr merge for safer merging
     • Add --retention-period flag to gh codespace create to control lifecycle
     • Add --org flag to gh codespace list, stop, and delete for admin workflows
     • Auto-generate SSH keys in gh codespace ssh instead of requiring pre-existing keys
     • Notify users in gh codespace create when usage is covered by an organization

     +2 more show less

     • Allow gh secret set to configure repository secrets scoped to Codespaces
     • Distribute Windows ARM precompiled binary and support arm64 extensions

     7 details in Everything

101. v2.12.0 Jun 8, 2022 · release notes

     gh pr merge adds pull requests to the repo's merge queue; gh codespace edit allows interactive codespace selection.

     └──▷ GET THIS VERSION

     copy

     $ git clone --branch v2.12.0 https://github.com/cli/cli.git
     # already have the repo? check out this version:
     $ git checkout v2.12.0

     • pr merge now checks if a base branch has a merge queue enabled and automatically adds the PR to that queue instead of merging it directly, when the GitHub API exposes this feature.
     • codespace edit supports interactive mode to select from a list of codespaces.

     2 details in Everything

102. v2.11.0 May 24, 2022 · release notes

     New extension exec subcommand, plus --upstream-remote-name, --include-all-branches, --pattern, and --debug flags across existing commands.

     └──▷ GET THIS VERSION

     copy

     $ git clone --branch v2.11.0 https://github.com/cli/cli.git
     # already have the repo? check out this version:
     $ git checkout v2.11.0

     └──▷ USE IT
     Execute a custom GitHub CLI extension script.
     shell copy

     gh extension exec my-extension

     Clone a repository and initialize the upstream remote with a custom name.
     shell copy

     gh repo clone owner/repo --upstream-remote-name origin-upstream

     Create a new repository and import all branches from the source.
     shell copy

     gh repo create my-new-repo --include-all-branches

     • extension exec: Add command for executing extensions
     • auth login: Add ability to set title for ssh key
     • repo clone: Add --upstream-remote-name flag
     • repo create: Add --include-all-branches flag
     • run download: Add --pattern flag

     +1 more show less

     • run rerun: Add --debug flag

     6 details in Everything

     └──▷ BREAKING ON UPGRADE

     • !secrets remove command renamed to secrets delete
103. v2.10.0 May 10, 2022 · release notes

     New label list, label remove, and codespace jupyter commands plus --json support for labels

     └──▷ GET THIS VERSION

     copy

     $ git clone --branch v2.10.0 https://github.com/cli/cli.git
     # already have the repo? check out this version:
     $ git checkout v2.10.0

     └──▷ TRY IT
     Delete a label named deprecated from the current repository.
     copy

     $ gh label remove deprecated

     Open a codespace for development in JupyterLab directly from the CLI.
     copy

     $ gh codespace jupyter

     List labels in JSON format for use in scripts or automation pipelines.
     copy

     $ gh label list --json name,description,id

     • label list now supports sorting labels in the output.
     • label remove command added to delete repository labels.
     • label list --json output format added for machine-readable label data.
     • repo list --visibility=internal flag added to filter lists to internal repositories only.
     • release list --exclude-drafts flag added to omit draft releases from listing.

     +1 more show less

     • codespace jupyter command added to open codespaces in JupyterLab.

     6 details in Everything

104. v2.9.0 Apr 26, 2022 · release notes

     GitHub CLI v2.9.0 introduces label edit and label clone commands, a --force flag for label creation, and multi devcontainer support.

     └──▷ GET THIS VERSION

     copy

     $ git clone --branch v2.9.0 https://github.com/cli/cli.git
     # already have the repo? check out this version:
     $ git checkout v2.9.0

     └──▷ TRY IT
     Copy all labels from one repository to another.
     copy

     $ gh label clone --source-owner <SOURCE_OWNER> <SOURCE_REPO>

     Force-create a label that might already exist in the target repository.
     copy

     $ gh label create --force "wont-fix"

     • label edit: Command to edit existing labels
     • label clone: Command to clone labels between repositories
     • label create: Add --force flag to forcibly create labels
     • codespaces: Support for multi devcontainer

     4 details in Everything

105. v2.8.0 Apr 13, 2022 · release notes

     GitHub CLI v2.8.0 adds release edit, new flags for issue/pr/extension commands, and M1 extension support

     └──▷ GET THIS VERSION

     copy

     $ git clone --branch v2.8.0 https://github.com/cli/cli.git
     # already have the repo? check out this version:
     $ git checkout v2.8.0

     └──▷ TRY IT
     Add a note to an existing release without updating binaries
     copy

     $ gh release edit v1.0 --notes "Fixed typos in docs"

     Previews which extensions will update without making changes
     copy

     $ gh extension upgrade --dry-run

     Open a codespace directly in the browser-based VS Code instead of desktop app
     copy

     $ gh codespace code --web

     • Adds the release edit command to modify existing GitHub releases from the CLI.
     • Adds the --comment flag to the issue close subcommand, allowing users to attach a comment when closing an issue via CLI.
     • Adds the --confirm flag to the issue delete subcommand to skip the confirmation prompt when deleting issues programmatically.
     • Adds the --web flag to the codespace code subcommand to open the codespace in Visual Studio Code web mode.
     • Makes the location argument optional in the codespace create command, enabling default workspace creation without specifying a region.

     +3 more show less

     • Adds the --dry-run flag to the extension upgrade subcommand to preview extensions that would be upgraded without performing the action.
     • Allows non-interactive file replacement in the gist edit command for scripted workflows.
     • Enables binary extension installation on M1 Macs, expanding supported platforms for third-party extensions.

     8 details in Everything

106. v2.7.0 Mar 30, 2022 · release notes

     GitHub CLI v2.7.0 adds gh status, gh search issues/pulls, and Dependabot secrets support

     └──▷ GET THIS VERSION

     copy

     $ git clone --branch v2.7.0 https://github.com/cli/cli.git
     # already have the repo? check out this version:
     $ git checkout v2.7.0

     └──▷ TRY IT
     View a consolidated list of all assigned issues, PRs, and notifications across your entire GitHub account without visiting the web UI.
     copy

     $ gh status

     Search for open issues in any repository matching a specific text string, such as timeout error.
     copy

     $ gh search issues 'timeout error' --state open

     Install an extension and lock it to version 1.2.0 to prevent unexpected updates in a CI pipeline.
     copy

     $ gh extension install github/gh-action-lint --version 1.2.0

     • gh status command displays issues, PRs assigned to you from anywhere on GitHub, review requests, mentions, and notifications
     • gh search issues and gh search pull-requests subcommands for searching across repositories
     • label list and label create commands for managing labels directly from the CLI
     • Ability to filter issue and pull request lists by application (e.g., Dependabot, Renovate)
     • extension install now supports pinning extensions to a specific version via a new option

     +2 more show less

     • Support for Dependabot secrets allows automated dependency updates within GitHub ActionsGitHub ActionsGitHub's built-in CI/CD system that runs automated workflows triggered by repository events, letting cyber tools automate testing, building, and releasing without managing separate pipeline infrastructure. workflows
     • New GH_DEBUG environment variable replaces the deprecated DEBUG variable for verbose mode

     7 details in Everything

     └──▷ BREAKING ON UPGRADE

     • !The DEBUG environment variable is deprecated in favor of GH_DEBUG for enabling verbose mode
107. v2.6.0 Mar 15, 2022 · release notes

     Adds gh search repos command for filtering repositories by language and issues; adds flags to gh run rerun and gh cs cp.

     └──▷ GET THIS VERSION

     copy

     $ git clone --branch v2.6.0 https://github.com/cli/cli.git
     # already have the repo? check out this version:
     $ git checkout v2.6.0

     └──▷ USE IT
     Search for Go repositories with at least 10 good-first-issue labels to find contributable projects.
     shell copy

     gh search repos --language=go --good-first-issues='>=10'

     • gh search repos --language=<value> enables repository searching with flags like --topic, --license, --good-first-issues, and --jq / --json for result processing
     • --failed flag on gh run rerun allows selectively rerunning only failed jobs in a workflow run
     • --job flag on gh run rerun allows specifying a specific job to rerun
     • --profile option added to gh cs cp command
     • Support for setting Dependabot secrets

     5 details in Everything

108. v2.5.2 Mar 1, 2022 · release notes

     Adds ls alias for all list commands; adds flags to gh auth login; supports filtering PRs by GitHub App and accepting permissions in Codespaces Create.

     └──▷ GET THIS VERSION

     copy

     $ git clone --branch v2.5.2 https://github.com/cli/cli.git
     # already have the repo? check out this version:
     $ git checkout v2.5.2

     └──▷ USE IT
     Use the shorter alias for listing pull requests.
     shell copy

     gh pr ls

     Create a codespace and automatically accept the required permissions.
     shell copy

     gh codespaces create --repo octocat/Hello-World --yes

     • Supports ls as an alias for the list subcommand across all commands (e.g. gh pr ls)
     • Adds --yes flag to gh codespaces create to allow accepting permissions automatically

     2 details in Everything

109. v2.5.1 Feb 15, 2022 · release notes

     GitHub CLI v2.5.1 adds --watch flag to pr checks and display names to Codespaces output

     └──▷ GET THIS VERSION

     copy

     $ git clone --branch v2.5.1 https://github.com/cli/cli.git
     # already have the repo? check out this version:
     $ git checkout v2.5.1

     └──▷ USE IT
     Monitor pull request checks until they complete or timeout, useful for CI/CD pipelines.
     shell copy

     gh pr checks --watch <PR_NUMBER>

     • Adds --watch flag to pr checks command for live polling of check statuses
     • Includes display name in Codespaces prompts and JSON output

     2 details in Everything

110. v2.5.0 Feb 1, 2022 · release notes

     GitHub CLI v2.5.0 adds codespace SSH config generation, deploy key management, and run filters via new CLI subcommands

     └──▷ GET THIS VERSION

     copy

     $ git clone --branch v2.5.0 https://github.com/cli/cli.git
     # already have the repo? check out this version:
     $ git checkout v2.5.0

     └──▷ USE IT
     Generate an OpenSSH config entry for a codespace to connect via native SSH clients.
     shell copy

     gh codespace ssh --config

     Delete a specific artifact from an existing GitHub release.
     shell copy

     gh release delete-asset v1.0.0 asset.tar.gz -R owner/repo

     Filter workflow runs by a specific branch and actor to isolate recent changes.
     shell copy

     gh run list --branch main --actor username -R owner/repo

     • Add codespace ssh --config to generate OpenSSH host configuration for your codespaces
     • Add release delete-asset to delete an asset from a release
     • Add repo deploy-key commands to manage deploy keys for a repository
     • auth git-credential: add ability to authenticate git operations for gist repositories
     • run list: add branch and actor filters

     +2 more show less

     • api: do not apply jq filters or render templates for HTTP error responses
     • pr create: fetch pull request template contents via the API

     7 details in Everything

111. v2.4.0 Dec 21, 2021 · release notes

     v2.4.0 adds repo edit, --generate-notes for releases, interactive tag selection, and JSON export for runs

     └──▷ GET THIS VERSION

     copy

     $ git clone --branch v2.4.0 https://github.com/cli/cli.git
     # already have the repo? check out this version:
     $ git checkout v2.4.0

     └──▷ TRY IT
     Rename a repo and set its description without leaving the terminal.
     copy

     $ gh repo edit my-project --name 'my-legacy-project' --description 'Old archive'

     Create a release with auto-generated notes based on commits since the last tag.
     copy

     $ gh release create v1.0.0 --generate-notes

     Import environment variables from a local .env file into GitHub ActionsGitHub ActionsGitHub's built-in CI/CD system that runs automated workflows triggered by repository events, letting cyber tools automate testing, building, and releasing without managing separate pipeline infrastructure. secrets for a specific repository.
     copy

     $ gh secret set --env-file .env --repo octo-org/octo-repo

     • Adds the repo edit subcommand to modify repository settings (name, description, URL, etc.) directly from the CLI.
     • Adds --generate-notes flag to gh release create to automatically generate release notes using the new release.create.generate_notes GraphQL field.
     • Allows gh pr merge to edit the commit subject line during a squash, rebase, or merge-commit action.
     • Adds --json flag to gh run list and gh run view to export data in JSON format for programmatic use.

     4 details in Everything

112. v2.3.0 Dec 2, 2021 · release notes

     New gh auth setup-git, gh config list, and precompiled extension support in v2.3.0

     └──▷ GET THIS VERSION

     copy

     $ git clone --branch v2.3.0 https://github.com/cli/cli.git
     # already have the repo? check out this version:
     $ git checkout v2.3.0

     └──▷ USE IT
     Set up credential helper for seamless GitHub authentication.
     shell copy

     gh auth setup-git

     Create a repo and immediately clone it locally.
     shell copy

     gh repo create myrepo --public --clone

     Print the encoded secret for gh secret set without storing it, useful for CI pipelines or external vaults.
     shell copy

     gh secret set MY_SECRET --body 'value' --no-store

     • gh repo create gains --clone to clone the newly created repo and --source=<path> to upload an existing local repository.
     • gh secret set supports --no-store flag to print the encoded secret value without saving it.
     • gh auth setup-git command added to configure gh-cli as a git credential helper.
     • gh config list command added to display the current configuration settings.
     • Cyber tooling now supports precompiled extension binaries (e.g. Go) via gh extension create scaffolding and release assets.

     5 details in Everything

     └──▷ BREAKING ON UPGRADE

     • !gh repo create no longer automatically adds a git remote to the local git repository in the current directory.
     • !gh repo create only prompts interactively when run with no arguments; all other cases require explicit arguments.
113. v2.2.0 Oct 25, 2021 · release notes

     GitHub CLI v2.2.0 adds gh codespace subcommand, repo delete, run cancel, and gpg-key management

     └──▷ GET THIS VERSION

     copy

     $ git clone --branch v2.2.0 https://github.com/cli/cli.git
     # already have the repo? check out this version:
     $ git checkout v2.2.0

     └──▷ TRY IT
     Create a new codespace in the current repository for remote development.
     copy

     $ gh codespace create --repo $(git remote get-url origin | sed 's/.*github.com[:/]//;s/.git$//')

     Delete a repository directly from the command line.
     copy

     $ gh repo delete <owner>/<repo>

     Manage GPG keys used for commit signing via CLI.
     copy

     $ gh gpg-key list --json id,title

     • Adds the gh codespace command (aliased as gh cs) for creating, listing, connecting to, and managing GitHub Codespaces.
     • Adds the gh repo delete command.
     • Adds the gh run cancel command.
     • Adds new gpg-key management commands (gh gpg-key).

     4 details in Everything

114. v2.1.0 Oct 14, 2021 · release notes

     GH CLI v2.1.0 adds repo archive, precompiled extensions, and new pr list/pr diff flags

     └──▷ GET THIS VERSION

     copy

     $ git clone --branch v2.1.0 https://github.com/cli/cli.git
     # already have the repo? check out this version:
     $ git checkout v2.1.0

     └──▷ TRY IT
     Create an archive of the current repository directly from the CLI.
     copy

     $ gh repo archive

     List only draft pull requests in the current repository.
     copy

     $ gh pr list --draft

     • Adds repo archive command to create a repository archive
     • Adds support for precompiled extension binaries downloaded via {OS}-{ARCH} suffixes in release assets
     • Adds --draft, --non-draft, and --head filters to pr list
     • Adds --patch flag to pr diff
     • Adds --commit flag to browse to open the permalink for the latest commit

     5 details in Everything

115. v2.0.0 Aug 24, 2021 · release notes

     GitHub CLI v2.0.0 introduces extension system, new commands, and configuration flags

     └──▷ GET THIS VERSION

     copy

     $ git clone --branch v2.0.0 https://github.com/cli/cli.git
     # already have the repo? check out this version:
     $ git checkout v2.0.0

     └──▷ USE IT
     Install a community extension and run its custom command.
     shell copy

     gh extension install owner/gh-my-extension && gh my-extension

     Force terminal output even when piped or redirected to a file.
     shell copy

     GH_FORCE_TTY=1 gh issue list

     • Adds gh extension install command to support third-party command extensions
     • Adds GH_FORCE_TTY environment variable to force terminal-style output when redirected
     • Adds config set browser option and GH_BROWSER environment variable for browser configuration
     • Adds repo sync command to synchronize a local branch with its upstream state
     • Adds tablerow/tablerender template functions for rendering data as tables

     +4 more show less

     • Adds pr checkout --branch flag to control the branch name during checkout
     • Adds release create --discussion-category flag for release discussion setup
     • Adds repo list --topic filter option
     • Display label colors in issue list output

     9 details in Everything

     └──▷ BREAKING ON UPGRADE

     • !Drops support for OS X El Capitan and requires Go 1.16+
     • !Removes backwards compatibility with homedir library for config files
116. v1.14.0 Aug 4, 2021 · release notes

     New pr merge --admin flag and enhanced shell completion for repo create and JSON output

     └──▷ GET THIS VERSION

     copy

     $ git clone --branch v1.14.0 https://github.com/cli/cli.git
     # already have the repo? check out this version:
     $ git checkout v1.14.0

     • Adds pr merge --admin flag to allow admins to force-merge a pull request
     • Improves shell completion for --json flag with multiple comma-separated fields
     • Adds completion for repo create --gitignore flag
     • Adds completion for repo create --license flag

     4 details in Everything

117. v1.13.0 Jul 20, 2021 · release notes

     Adds gh browse --no-browser flag and colored labels to issue/pr view

     └──▷ GET THIS VERSION

     copy

     $ git clone --branch v1.13.0 https://github.com/cli/cli.git
     # already have the repo? check out this version:
     $ git checkout v1.13.0

     └──▷ USE IT
     Scripting repository browsing by capturing the URL without triggering a browser launch.
     shell copy

     gh browse --no-browser

     • Adds --no-browser flag to gh browse to print URL without opening a browser
     • issue/pr view: outputs label names in their own color

     2 details in Everything

118. v1.12.0 Jun 29, 2021 · release notes

     Adds gh browse command, .gitignore/LICENSE templates for repo create, and http_unix_socket config

     └──▷ GET THIS VERSION

     copy

     $ git clone --branch v1.12.0 https://github.com/cli/cli.git
     # already have the repo? check out this version:
     $ git checkout v1.12.0

     └──▷ TRY IT
     Open the settings page for the current repository without leaving the terminal.
     copy

     $ gh browse --settings

     Open a specific file and line number in your browser to share context with teammates.
     copy

     $ gh browse pkg/cmd/repo/garden/garden.go:520

     • gh browse --settings to open repository settings directly from the terminal
     • gh browse <file>:<line> to open specific code lines in a browser
     • New templates selection when creating repositories with gh repo create for .gitignore and LICENSE files
     • Config key http_unix_socket added to .config/gh/config.yml to route all gh traffic over a local Unix socket

     4 details in Everything

119. v1.11.0 Jun 3, 2021 · release notes

     gh now supports GitHub ActionsGitHub ActionsGitHub's built-in CI/CD system that runs automated workflows triggered by repository events, letting cyber tools automate testing, building, and releasing without managing separate pipeline infrastructure. environment secrets, XDGXDGA set of specifications maintained by freedesktop.org that standardise where Linux applications store config, data, and cache files, letting tools respect user-defined paths instead of hardcoding locations. config paths, and run list age columns

     └──▷ GET THIS VERSION

     copy

     $ git clone --branch v1.11.0 https://github.com/cli/cli.git
     # already have the repo? check out this version:
     $ git checkout v1.11.0

     └──▷ USE IT
     List all secrets associated with a specific GitHub Actions environment
     shell copy

     gh secret list --env production

     • Adds run list column headers and an age column to display workflow run duration
     • Adopts XDG Base Directory specification for configuration storage paths
     • Changes default config directory on Windows from ~/.config/gh/ to %AppData%
     • Includes PR or issue number alongside the title in issue/pr view output

     4 details in Everything

120. v1.10.0 May 18, 2021 · release notes

     GH CLI v1.10.0 adds --org to repo fork, JSON export flags to repo/release/issue/pr commands, and stdin support for alias set.

     └──▷ GET THIS VERSION

     copy

     $ git clone --branch v1.10.0 https://github.com/cli/cli.git
     # already have the repo? check out this version:
     $ git checkout v1.10.0

     └──▷ USE IT
     Fork a repository into your corporate org account.
     shell copy

     gh repo fork <owner>/<repo> --org <org-name>

     Export PR data in JSON format to pipe into another tool.
     shell copy

     gh pr view 123 --json title,commits | jq -r '.title'

     • Adds gh repo fork --org <org> flag to fork repositories into a specific organization rather than the user's personal account.
     • Adds --json flag support to gh repo list/view, gh release view, and gh issue/pr view for structured data output.
     • Extends JSON export fields for PRs/Issues: adds commits field, fixes closed, createdAt, mergedAt, files, and milestone fields, and increases comment limit in gh issue view --json comments.
     • Allows passing the value for gh alias set via standard input (stdin).
     • Adds shell completion for valid --json flag values on supported commands.

     +1 more show less

     • Updates gh api placeholder syntax to {owner} and {repo} to align with GitHub API documentation.

     6 details in Everything

121. v1.9.0 Apr 14, 2021 · release notes

     Adds gh run/workflow/actions commands for Actions integration and --json export for PR/Issue commands

     └──▷ GET THIS VERSION

     copy

     $ git clone --branch v1.9.0 https://github.com/cli/cli.git
     # already have the repo? check out this version:
     $ git checkout v1.9.0

     └──▷ TRY IT
     View a specific workflow run's logs directly from the terminal.
     copy

     $ gh run view --log-failed

     • Adds gh run, gh workflow, and gh actions top-level commands to interact with GitHub ActionsGitHub ActionsGitHub's built-in CI/CD system that runs automated workflows triggered by repository events, letting cyber tools automate testing, building, and releasing without managing separate pipeline infrastructure.

     1 detail in Everything

122. v1.8.0 Mar 30, 2021 · release notes

     gh CLI v1.8.0 adds --search to issue/pr list, new issue transfer command, and more

     └──▷ GET THIS VERSION

     copy

     $ git clone --branch v1.8.0 https://github.com/cli/cli.git
     # already have the repo? check out this version:
     $ git checkout v1.8.0

     └──▷ USE IT
     Find open issues containing crash in the title to triage urgent bugs quickly.
     shell copy

     gh issue list --state open --search "crash in:title"

     Filter pull requests by a specific author to review their recent contributions.
     shell copy

     gh pr list --author <username>

     • gh issue/pr list --search flag enables keyword and GitHub search syntax filtering for issues and pull requests
     • issue transfer subcommand added to reassign ownership of an issue or pull request
     • pr list --author filter option added to filter pull requests by author
     • pr view now displays diffstat information alongside the PR details
     • --body-file flag accepted wherever --body is supported across issue and PR commands

     5 details in Everything

     └──▷ BREAKING ON UPGRADE

     • !issue/pr list now combines multiple labels using AND logic instead of the previous OR behavior, changing result filtering for existing scripts.
123. v1.7.0 Mar 4, 2021 · release notes

     gh repo list command adds new repo subcommand and api --jq/--template/--cache/--preview options for enhanced scripting.

     └──▷ GET THIS VERSION

     copy

     $ git clone --branch v1.7.0 https://github.com/cli/cli.git
     # already have the repo? check out this version:
     $ git checkout v1.7.0

     └──▷ USE IT
     List all repositories for the current user via the new repo list command.
     shell copy

     gh repo list

     Extract repository name and description from API JSON using the new --jq filter in the api command.
     shell copy

     gh api repos/:owner/:repo --jq '.full_name, .description'

     Format API search results using Go templates with the new --template option.
     shell copy

     template='{{ range .items -}}\n{{.full_name | color "blue+h"}} ({{.stargazers_count | color "yellow"}})\n{{ end }}'; gh api -X GET search/repositories -f q='cli language:go' -f per_page=10 -t "$template"

     • Adds the gh repo list command to list GitHub repositories under a user or organization account
     • Adds --jq option to gh api to filter JSON output using jq syntax without requiring the external jq utility
     • Adds --template option to gh api to render output using Go templates
     • Adds --cache option to gh api to cache API responses on disk for a specified time
     • Adds --preview option to gh api to opt into GitHub API preview headers

     +4 more show less

     • Adds support for passing body from file or standard input to issue/pr create
     • Adds --base flag to pr edit command to change the base branch of a PR
     • Allows pr edit and gist view commands to be run without arguments to use interactive prompts
     • Adds -a <file> flag to gist edit to add files to a gist

     9 details in Everything

124. v1.6.0 Feb 17, 2021 · release notes

     New gh issue/ssh-key/pr commands, PR auto-merge, SSH key generation during auth, and new flags.

     └──▷ GET THIS VERSION

     copy

     $ git clone --branch v1.6.0 https://github.com/cli/cli.git
     # already have the repo? check out this version:
     $ git checkout v1.6.0

     └──▷ USE IT
     Enable automatic merging of a PR once CI passes and reviews are in place.
     shell copy

     gh pr merge --auto

     List the SSH keys currently associated with your GitHub account.
     shell copy

     gh ssh-key list

     • gh issue edit and gh pr edit subcommands allow modifying existing issues and PRs non-interactively or via interactive prompts
     • gh ssh-key list and gh ssh-key add subcommands for managing SSH keys
     • gh issue delete subcommand to permanently delete an issue
     • --auto flag on gh pr merge to enable auto-merge once requirements are met
     • SSH key generation and upload during the gh auth login flow

     +9 more show less

     • @me syntax support in gh issue create for self-assignment
     • --force and --detach flags on gh pr checkout
     • Git flag support in repo fork subcommand
     • Commit body editing capability in pr merge subcommand
     • Unpushed commit alerting in pr merge subcommand
     • --files flag on gist view to list filenames
     • Environment variable support for specifying the configuration path
     • Branch up-to-date status display in gh pr status output
     • Progress indicator during new pull request creation

     14 details in Everything

125. v1.5.0 Jan 21, 2021 · release notes

     GitHub CLI v1.5.0 introduces issue/PR commenting, gist cloning, and enhanced PR review visibility.

     └──▷ GET THIS VERSION

     copy

     $ git clone --branch v1.5.0 https://github.com/cli/cli.git
     # already have the repo? check out this version:
     $ git checkout v1.5.0

     └──▷ USE IT
     Comment on an open issue to discuss a bug without leaving the CLI.
     shell copy

     gh issue comment 123 --body 'This looks like a regression in v2.0'

     Clone all files from a public gist for local analysis.
     shell copy

     gh gist clone abc123def

     Fork a repository and name the remote upstream-fork instead of the default origin.
     shell copy

     gh repo fork octocat/Hello-World --remote-name upstream-fork

     • Adds gh issue comment command to post comments on issues.
     • Adds gh pr comment command to post comments on pull requests.
     • Adds gh gist clone command to clone gists.
     • pr view now displays top-level review comments inline with regular comments.
     • repo fork adds support for specifying the fork remote name.

     5 details in Everything

126. v1.4.0 Dec 15, 2020 · release notes

     GitHub CLI v1.4.0 adds gh secret commands and comment thread viewing via --comments flag

     └──▷ GET THIS VERSION

     copy

     $ git clone --branch v1.4.0 https://github.com/cli/cli.git
     # already have the repo? check out this version:
     $ git checkout v1.4.0

     └──▷ TRY IT
     Push a local file content as a secret named API_KEY to the current repository.
     copy

     $ gh secret set API_KEY < api_key.txt

     Display the complete discussion thread for issue #42 without navigating to the browser.
     copy

     $ gh issue view 42 --comments

     • Adds the gh secret subcommand group with set, list, and delete (implied by remove) capabilities for managing repository or organization secrets.
     • Adds a --comments flag to gh issue view and gh pr view to render the full comment thread output.
     • Enables automatic git credential helper configuration during gh auth login flow, removing the need for separate git authentication setup.

     3 details in Everything

127. v1.3.0 Nov 24, 2020 · release notes

     Adds --recover flag to pr create and issue create, plus new auth environment variables

     └──▷ GET THIS VERSION

     copy

     $ git clone --branch v1.3.0 https://github.com/cli/cli.git
     # already have the repo? check out this version:
     $ git checkout v1.3.0

     └──▷ USE IT
     Resume a failed interactive PR creation session using saved state.
     shell copy

     gh pr create --recover

     Authenticate using the enterprise token environment variable instead of default config.
     shell copy

     GH_ENTERPRISE_TOKEN=abc123 gh pr list

     • pr create now supports --recover option to resume from saved input after a failed interactive invocation
     • issue create now supports --recover option to resume from saved input after a failed interactive invocation
     • Adds support for GH_TOKEN environment variable for authentication
     • Adds support for GH_ENTERPRISE_TOKEN environment variable for authentication

     4 details in Everything

128. v1.2.0 Oct 27, 2020 · release notes

     GitHub CLI v1.2.0 adds multi-host API support, token visibility, CI update-skip var, and Codespaces integration tokens.

     └──▷ GET THIS VERSION

     copy

     $ git clone --branch v1.2.0 https://github.com/cli/cli.git
     # already have the repo? check out this version:
     $ git checkout v1.2.0

     └──▷ TRY IT
     Run GraphQL queries against a GitHub Enterprise instance directly from the CLI
     copy

     $ gh api --hostname ghe.example.com graphql -f query='{ repository(owner: "org", name: "repo") { name } }'

     Display the active authentication token value for debugging purposes
     copy

     $ gh auth status --show-token

     Suppress update prompts during CI pipeline execution
     copy

     $ export GH_NO_UPDATE_NOTIFIER=1 && gh pr list

     • Adds --hostname flag to the api command to target arbitrary GitHub Enterprise hosts
     • Adds --scopes flag to auth login for explicit authorization scope selection
     • Adds --show-token flag to auth status to display the current auth token in plaintext
     • Adds GH_NO_UPDATE_NOTIFIER environment variable to disable update check prompts

     4 details in Everything

129. v1.1.0 Oct 6, 2020 · release notes

     GitHub CLI v1.1.0 adds GH_PAGER env var, branch selection to repo view, and gist improvements

     └──▷ GET THIS VERSION

     copy

     $ git clone --branch v1.1.0 https://github.com/cli/cli.git
     # already have the repo? check out this version:
     $ git checkout v1.1.0

     └──▷ USE IT
     Bypass the interactive pager by piping output directly to stdout.
     shell copy

     GH_PAGER=cat gh repo view my-org/my-repo

     View details for a specific branch rather than the default HEAD.
     shell copy

     gh repo view --branch feature/new-feature

     • Adds support for the GH_PAGER environment variable to override the default pager
     • Disables terminal paging when GH_PAGER is set to cat
     • Adds --branch option to repo view to specify a branch for viewing

     3 details in Everything

130. v1.0.0 Sep 16, 2020 · release notes

     GitHub CLI v1.0 introduces gh release, gh gist list/view/edit, and new flags for PR creation and auth

     └──▷ GET THIS VERSION

     copy

     $ git clone --branch v1.0.0 https://github.com/cli/cli.git
     # already have the repo? check out this version:
     $ git checkout v1.0.0

     • Adds gh release commands for managing GitHub Releases
     • Adds gh pr checks command to check pull request statuses
     • Adds gh gist list, gh gist view, and gh gist edit commands for Gist management
     • Adds --head <branch> flag to gh pr create to explicitly set the head branch
     • Adds gh auth login --web flag for web-based authentication flow

     +3 more show less

     • Adds prompt disabled value to gh config set prompt config setting
     • Adds gh help environment topic listing all supported environment variables
     • Adds support for PAGER environment variable and pager config option for terminal paging

     8 details in Everything

131. v0.12.0 Sep 8, 2020 · release notes

     Adds gh auth, gh repo create --template, GHE support via GH_HOST, and gh pr flag improvements

     └──▷ GET THIS VERSION

     copy

     $ git clone --branch v0.12.0 https://github.com/cli/cli.git
     # already have the repo? check out this version:
     $ git checkout v0.12.0

     • Introduces gh auth status, gh auth login, gh auth refresh, and gh auth logout commands for authentication management
     • Adds support for GitHub Enterprise Server using GH_HOST environment variable to set the default hostname
     • Implements OAuth Device Authorization flow for github.com to enable browserless authentication
     • Enables creating repositories from templates via gh repo create <reponame> --template <owner>/<templaterepo>
     • Enables paging gh pr diff output by respecting the PAGER environment variable

     +6 more show less

     • Adds --recurse-submodules flag to gh pr checkout command
     • Adds --delete-branch flag to gh pr close command
     • Allows omitting the owner in gh repo view <reponame> instead of requiring <owner>/<reponame>
     • Includes issue/pr number and URL in machine-readable output for gh issue/pr view
     • Adds :branch placeholder support in gh api command
     • Supports GraphQL operationName field filtering in gh api command

     11 details in Everything

132. v0.11.1 Jul 28, 2020 · release notes

     GitHub CLI v0.11.1 adds GLAMOUR_STYLE env var for custom color themes

     └──▷ GET THIS VERSION

     copy

     $ git clone --branch v0.11.1 https://github.com/cli/cli.git
     # already have the repo? check out this version:
     $ git checkout v0.11.1

133. v0.11.0 Jul 16, 2020 · release notes

     Adds shell aliases, --milestone/--mention filters, --web flag, and gh api --silent to v0.11.0

     └──▷ GET THIS VERSION

     copy

     $ git clone --branch v0.11.0 https://github.com/cli/cli.git
     # already have the repo? check out this version:
     $ git checkout v0.11.0

     └──▷ TRY IT
     Run gh api in scripts without capturing the response body.
     copy

     $ gh api --silent /repos/{owner}/{repo}/issues

     Filter issues by milestone and mention using the new flags.
     copy

     $ gh issue list --milestone 'v1.0' --mention @octocat

     Open a PR or issue list directly in the web browser.
     copy

     $ gh pr list --web

     • gh api --silent flag added to suppress HTTP response printing
     • --milestone and --mention filters added to gh issue list
     • --web flag added to gh issue/pr list commands
     • Support for shell aliases introduced in the configuration system

     4 details in Everything

134. v0.10.1 Jun 24, 2020 · release notes

     gh api --paginate flag enables recursive fetching of paginated REST and GraphQL API results

     └──▷ GET THIS VERSION

     copy

     $ git clone --branch v0.10.1 https://github.com/cli/cli.git
     # already have the repo? check out this version:
     $ git checkout v0.10.1

     └──▷ USE IT
     Fetch all repositories for the authenticated user without manual loop logic
     shell copy

     gh api --paginate -XGET user/repos | jq -r '.[].full_name'

     Paginate through GraphQL results using cursor-based navigation
     shell copy

     gh api --paginate graphql -f query='query($endCursor: String) { viewer { repositories(first: 100, after: $endCursor) { nodes { nameWithOwner } pageInfo { endCursor hasNextPage } } } }'

     • Adds the --paginate flag to the gh api command to automatically fetch all pages of results
     • Supports pagination for both REST endpoints (using Link headers) and GraphQL queries (using cursor-based pagination)

     2 details in Everything

135. v0.10.0 Jun 11, 2020 · release notes

     GitHub CLI v0.10.0 adds gh api, gh alias, GITHUB_TOKEN support, and config split.

     └──▷ GET THIS VERSION

     copy

     $ git clone --branch v0.10.0 https://github.com/cli/cli.git
     # already have the repo? check out this version:
     $ git checkout v0.10.0

     └──▷ TRY IT
     Query the GitHub REST APIREST APIA web API design style where clients interact with resources over HTTP using standard methods like GET, POST, and DELETE, giving cyber tools a predictable, language-agnostic way to integrate with external services. for releases of a repository
     copy

     $ gh api repos/:owner/:repo/releases

     Create a shortcut alias heart to react with an emoji via the API
     copy

     $ gh alias set heart 'api -H Accept:application/vnd.github.squirrel-girl-preview+json repos/:owner/:repo/issues/$1/reactions --raw-field content=heart'

     • Adds gh api command to access GitHub GraphQL and REST APIsREST APIsA convention for building HTTP-based interfaces where resources are addressed by URL and manipulated with standard verbs like GET, POST, and DELETE, giving cyber tools a predictable way to integrate with external services.
     • Adds gh alias command with $1, $2 positional placeholders
     • Respects GITHUB_TOKEN environment variable for authentication
     • Splits configuration into config.yml and hosts.yml files

     4 details in Everything

136. v0.9.0 May 26, 2020 · release notes

     Adds gh pr diff, gh pr review, gh pr merge, and gh pr ready commands for pull request workflows.

     └──▷ GET THIS VERSION

     copy

     $ git clone --branch v0.9.0 https://github.com/cli/cli.git
     # already have the repo? check out this version:
     $ git checkout v0.9.0

     └──▷ USE IT
     Approve and comment on a pull request programmatically or in non-interactive scripts.
     shell copy

     gh pr review --approve -b "lgtm" <pr-number>

     • Adds the gh pr diff subcommand to view pull request diffs
     • Adds the gh pr review subcommand with support for the --approve flag and -b body text for automated reviews
     • Adds the gh pr merge subcommand to merge pull requests
     • Adds the gh pr ready subcommand to mark draft pull requests as ready for review

     4 details in Everything

137. v0.8.0 May 11, 2020 · release notes

     gh pr issue create supports --add-metadata flag and gh adds new pr close/reopen subcommands

     └──▷ GET THIS VERSION

     copy

     $ git clone --branch v0.8.0 https://github.com/cli/cli.git
     # already have the repo? check out this version:
     $ git checkout v0.8.0

     └──▷ USE IT
     Create a PR with labels and reviewers specified directly, avoiding interactive prompts
     shell copy

     gh pr create --add-metadata --label "bug" --label "urgent" --reviewer monalisa

     Close a specific pull request by number via the CLI
     shell copy

     gh pr close 123

     • pr create and issue create gain the --add-metadata flag to assign reviewers, labels, and more without interactive prompts
     • pr close <number> subcommand added to close a pull request
     • pr reopen <number> subcommand added to reopen a pull request
     • pr view now displays Reviewers

     4 details in Everything

138. v0.7.0 Apr 22, 2020 · release notes

     Introduces gh config command for SSH remote defaulting and editor preference

     └──▷ GET THIS VERSION

     copy

     $ git clone --branch v0.7.0 https://github.com/cli/cli.git
     # already have the repo? check out this version:
     $ git checkout v0.7.0

     └──▷ USE IT
     Use gh config to set SSH as the default protocol for Git operations.
     shell copy

     gh config set git-protocol ssh

     Run CLI commands without ANSI color codes, useful for piping output in scripts.
     shell copy

     NO_COLOR=1 gh pr list

     • gh config command to control GH usage defaults like preferring SSH git remotes
     • Support for the NO_COLOR environment variable to disable colored output

     2 details in Everything

139. v0.6.3 Mar 31, 2020 · release notes

     GitHub CLI v0.6.3 adds automatic upstream remote setup for forks and terminal-based repo viewing.

     └──▷ GET THIS VERSION

     copy

     $ git clone --branch v0.6.3 https://github.com/cli/cli.git
     # already have the repo? check out this version:
     $ git checkout v0.6.3

     └──▷ USE IT
     Inspect repository details in the terminal without opening a browser.
     shell copy

     gh repo view github/cli

     • Adds automatic upstream remote setup after gh repo fork
     • Enables viewing a repository directly in the terminal via gh repo view

     2 details in Everything

140. v0.6.2 Mar 18, 2020 · release notes

     gh v0.6.2 adds author filtering to issue/pr list, PowerShell completion, and PR autofill from commits

     └──▷ GET THIS VERSION

     copy

     $ git clone --branch v0.6.2 https://github.com/cli/cli.git
     # already have the repo? check out this version:
     $ git checkout v0.6.2

     └──▷ USE IT
     Generate completion script for PowerShell and source it in your profile.
     shell copy

     gh completion --shell=PowerShell >> $PROFILE

     • Adds the --author filter to gh issue list and gh pr list to filter results by creator
     • Adds PowerShell as a supported shell for tab-completion via gh completion --shell=PowerShell
     • Enables autofilling the title and body of a new pull request with information from git commit messages when using gh pr create

     3 details in Everything

141. v0.6.0 Mar 3, 2020 · release notes

     GitHub CLI v0.6.0 introduces four new repo subcommands for cloning, creating, forking, and viewing repositories.

     └──▷ GET THIS VERSION

     copy

     $ git clone --branch v0.6.0 https://github.com/cli/cli.git
     # already have the repo? check out this version:
     $ git checkout v0.6.0

     └──▷ TRY IT
     Clone a remote repository into the local working directory.
     copy

     $ gh repo clone octocat/Spoon-Knife

     Create a new public repository owned by the authenticated user.
     copy

     $ gh repo create my-new-repo --public

     View details of a specific repository in the terminal.
     copy

     $ gh repo view cli/cli

     • Adds repo clone <repo> command
     • Adds repo create command
     • Adds repo fork command
     • Adds repo view command

     4 details in Everything

142. v0.5.6 Feb 20, 2020 · release notes

     GitHub CLI v0.5.6 adds arm64 Linux builds and reproducible build support.

     └──▷ GET THIS VERSION

     copy

     $ git clone --branch v0.5.6 https://github.com/cli/cli.git
     # already have the repo? check out this version:
     $ git checkout v0.5.6

     • Provides official linux builds for the arm64 architecture

     1 detail in Everything

143. v0.5.5 Feb 13, 2020 · release notes

     GitHub CLI v0.5.5 introduces cross-repository PR creation and configurable git editor precedence.

     └──▷ GET THIS VERSION

     copy

     $ git clone --branch v0.5.5 https://github.com/cli/cli.git
     # already have the repo? check out this version:
     $ git checkout v0.5.5

     • Enables creating pull requests across different repositories via cross repo pr create

     1 detail in Everything

144. v0.5.3 Feb 4, 2020 · release notes

     Adds native fish shell completion support via gh completion and Homebrew/scoop integrations

     └──▷ GET THIS VERSION

     copy

     $ git clone --branch v0.5.3 https://github.com/cli/cli.git
     # already have the repo? check out this version:
     $ git checkout v0.5.3

     • Configures gh for scoop package manager installation
     • Automatically sets up fish completion when installing via Homebrew

     2 details in Everything

145. v0.5.0 Jan 23, 2020 · release notes

     GitHub CLI v0.5.0 adds web UI finalization for issues/PRs and fork support in pr create

     └──▷ GET THIS VERSION

     copy

     $ git clone --branch v0.5.0 https://github.com/cli/cli.git
     # already have the repo? check out this version:
     $ git checkout v0.5.0

     • issue/pr create now offers to finalize editing in the web UI #231
     • pr create now supports contributing from forks #238

     2 details in Everything

146. v0.4.0 Jan 14, 2020 · release notes

     GitHub CLI v0.4.0 adds template support to issue/create commands

     └──▷ GET THIS VERSION

     copy

     $ git clone --branch v0.4.0 https://github.com/cli/cli.git
     # already have the repo? check out this version:
     $ git checkout v0.4.0

     └──▷ USE IT
     Create an issue or PR using a predefined repository template.
     shell copy

     gh issue create --template bug_report.md