Github CLI Updates & Release Notes

Expiring, auto-refreshing OAuth tokens (preview)

gh can now sign in with expiring OAuth credentials that it refreshes automatically. When you opt in, gh stores a short-lived access token alongside a rotating refresh token and refreshes the access token whenever it is needed, so you stay signed in without having to authenticate again.

To opt in for a single sign-in, run:

gh auth login --expiring

To prefer expiring credentials for every sign-in, run:

gh config set expiring_credentials enabled

gh auth status shows whether a credential is refreshable and when the current access token expires. Both gh auth status and gh auth token automatically refresh the access token when needed. Expiring tokens are available on github.com and GHE.com; on hosts that do not issue them, gh falls back to a regular non-expiring token.

If you use HTTPS as your git protocol, we advise using git 2.46 or newer and letting gh act as your git credential helper by running gh auth setup-git. This way gh serves and refreshes the expiring credential for git, and git does not cache it past its lifetime.

Important

Expiring access tokens should not be cached. Scripts and extensions that store the output of gh auth token will eventually hold an expired token, so run gh auth token again each time a token is needed. Tokens supplied through GH_TOKEN or GITHUB_TOKEN are never refreshed.

For more information, see Authenticating with GitHub CLI.

Manage issue artifacts with gh issue artifact (private preview)

gh issue artifact brings issue artifacts to the command line. Users and organizations enrolled in the private preview can use the list, view, create, edit, download, and delete commands to manage issue artifacts.

# Create a Markdown document with an attached image
gh issue artifact create 142 signin-plan.md --attach ./signin-flow.png

# Create an HTML document
gh issue artifact create 142 menu-prototype.html

# List or view artifacts
gh issue artifact list 142
gh issue artifact view 142 2

# Update a document or restore an earlier version
gh issue artifact edit 142 2 --body-file signin-plan-v2.md
gh issue artifact edit 142 2 --restore-version 5

Artifacts can also be addressed by their GitHub URLs, and Markdown documents support image and video attachments with --attach.

Important

Issue artifacts are in private preview. These commands only work for repositories enrolled in the preview. See the Issue Artifacts private preview announcement and feedback discussion for access instructions and to share feedback.

What's Changed

✨ Features

• Replace extension browse with Bubble Tea by @williammartin in #14578
• gh issue artifact stack 1/12: Resolve --attach references against the body file's directory by @BagToad in #14564
• gh issue artifact stack 2/12: Attach one set of files to several Markdown documents by @BagToad in #14565
• gh issue artifact stack 3/12: Add the command group and list by @BagToad in #14566
• gh issue artifact stack 4/12: Add view by @BagToad in #14567
• gh issue artifact stack 5/12: Add delete by @BagToad in #14568
• gh issue artifact stack 6/12: Add download by @BagToad in #14569
• gh issue artifact stack 7/12: Add create by @BagToad in #14570
• gh issue artifact stack 8/12: Add edit by @BagToad in #14571
• gh issue artifact stack 10/12: Add edit --restore-version by @BagToad in #14580
• gh issue artifact stack 11/12: Address review feedback by @BagToad in #14640
• gh issue artifact stack 12/12: Add artifact URLs by @BagToad in #14678
• Support HTML documents in gh issue artifact by @BagToad in #14720
• Refreshable tokens (1/7): foundation credential model, storage migration, and file lock by @babakks in #14450
• Refreshable tokens (2/7): refresher domain, OAuth refresher, storage, and wiring by @babakks in #14451
• Refreshable tokens (3/7): short-lived login, refresh, and git credential path by @babakks in #14452
• Refreshable tokens (4/7): gh auth token refresh and secure-storage handling by @babakks in #14453
• Refreshable tokens (5/7): gh auth status short-lived token details by @babakks in #14454
• Refreshable tokens (6/7): agent-task and CAPI per-request refresh by @babakks in #14455
• Refreshable tokens: review fixes across the stack by @babakks in #14663
• Refreshable tokens: rename --short-lived flag to --expiring by @babakks in #14665
• Refreshable tokens: add prefer_expiring_credentials config option by @babakks in #14672
• Refreshable tokens: capture auth_invocation telemetry on login and refresh by @babakks in #14673
• Refreshable tokens: review fixes (round 2) by @babakks in #14717
• Refreshable tokens: show relative time-to-expiry in gh auth status by @babakks in #14745
• Refreshable tokens: build-gated debug overrides for testing token expiry by @babakks in #14752
• Refreshable tokens: bump cli/oauth to v1.3.0 and fix gh status column width by @babakks in #14768

🐛 Fixes

• Bump go-runewidth to v0.0.30 for faster startup by @williammartin in #14577
• Avoid spawning git for each extension at startup by @williammartin in #14620
• Fix the unclean background colors of gh-search-code by @A4-Tacks in #14648
• Fix help text that references nonexistent flags by @BagToad in #14719

📚 Docs & Chores

• docs: recommend nix-shell and declarative config for Nix/NixOS by @reginaldalfret in #14592
• Clarify issue view comment output modes by @babakks with @Copilot in #14616
• Add ACCESSIBILITY.md by @BagToad in #14583
• Bump shell-quote to 1.11.0 in cli-exercise skill by @williammartin in #14625
• Leave validation checks to CI in bump-go script by @williammartin in #14631
• Remove CLAUDE.md in favor of AGENTS.md by @jarrensj in #14474
• Clarify --repo and --owner checks for attestation bundles by @bdehamer in #14650
• Fix Go vendoring in Dependabot triage and bump gh-aw by @williammartin in #14682
• gh issue artifact stack 9/12: Document gh issue artifact in the gh skill by @BagToad in #14572
• Clarify --comments behavior when piped in view commands by @arsalanyavari in #14714
• Clarify release creation atomicity and immutability by @bdehamer in #14722
• Add deterministic Dependabot scheduler by @williammartin in #14750
• Merge v2.102.1 release branch into trunk by @BagToad in #14770
• Refreshable tokens (7/7): guided end-to-end verification scripts by @babakks in #14456
• Document expiring tokens in the gh skill by @babakks in #14782

Dependencies

• Bump Go to 1.27.2 by @github-actions[bot] in #14632
• chore(deps): bump golang.org/x/sync from 0.23.0 to 0.24.0 by @dependabot[bot] in #14633
• chore(deps): bump github.com/mattn/go-colorable from 0.1.15 to 0.1.16 by @dependabot[bot] in #14634
• chore(deps): bump golang.org/x/crypto from 0.57.0 to 0.58.0 by @dependabot[bot] in #14660
• chore(deps): bump actions/upload-artifact from 7.0.1 to 7.0.2 by @dependabot[bot] in #14656
• chore(deps): bump actions/download-artifact from 8.0.1 to 8.0.2 by @dependabot[bot] in #14655
• chore(deps): bump the codeql-actions group with 3 updates by @dependabot[bot] in #14654
• chore(deps): bump charm.land/bubbletea/v2 from 2.0.10 to 2.1.0 by @dependabot[bot] in #14657
• chore(deps): bump google.golang.org/grpc from 1.83.2 to 1.84.0 by @dependabot[bot] in #14485
• chore(deps): bump github.com/cli/go-gh/v2 from 2.16.1 to 2.16.2 by @dependabot[bot] in #14696
• chore(deps): bump actions/setup-node from 7.0.0 to 7.1.0 by @dependabot[bot] in #14697
• chore(deps): bump goreleaser/goreleaser-action from 7.2.3 to 7.3.0 by @dependabot[bot] in #14707
• chore(deps): bump github.com/klauspost/compress from 1.20.1 to 1.20.3 by @dependabot[bot] in #14705
• chore(deps): bump actions/create-github-app-token from 3.2.0 to 3.3.0 by @dependabot[bot] in #14706
• chore(deps): bump the codeql-actions group with 3 updates by @dependabot[bot] in #14751
• Bump Go to 1.27.3 by @github-actions[bot] in #14767
• chore(deps): bump github.com/gabriel-vasile/mimetype from 1.4.15 to 1.4.16 by @dependabot[bot] in #14766
• Update glamour to v2 by @heaths in #14148

New Contributors

• @reginaldalfret made their first contribution in #14592
• @jarrensj made their first contribution in #14474
• @A4-Tacks made their first contribution in #14648
• @arsalanyavari made their first contribution in #14714

Full Changelog: v2.102.1...v2.103.0

Security

Four security vulnerabilities have been identified, and fixed, in this release. Users are advised to update gh to version v2.102.0 as soon as possible.

gh release download, gh run download, gh repo read-file --output, and gh attestation download could write remote content to an unintended local file when the destination contained symbolic links.

See GHSA-39wj-f2f4-978v for more information.

gh attestation verify compared the --source-ref value case-insensitively, so an attestation built from a branch whose name differs only in case could satisfy a policy that named a different branch.

See GHSA-4mq3-hpgx-9cx8 for more information.

Interactive gh skill search passed repository paths from search results to gh skill install without an option separator, so a search result could inject installer options and change where skill files were written.

See GHSA-qcwj-mr2r-2cx7 for more information.

gh attestation verify matched the --signer-workflow value against only the start of the signing certificate's identity, so an attestation signed by a different workflow in the pinned repository could pass verification when its path began with the pinned value.

See GHSA-wjmr-j3rp-mh2g for more information.

What's Changed

🐛 Fixes

• Allow ghu_ tokens for supported actors to attach files by @BagToad in #14516
• Allow repo set-default --unset without an argument by @williammartin in #14540

📚 Docs & Chores

• Prioritize HackerOne for vulnerability reports by @BagToad in #14497
• Clarify reviewer-facing PR guidance by @williammartin in #14509
• Add a skill for chaptered CLI recordings by @BagToad in #14475
• Improve CLI recording rendering by @williammartin in #14507
• Mention gh CLI in the README intro by @BagToad in #14517
• Document search operator support in gh search help by @waldyrious in #14519
• Remove host versions from gh project item-list help by @BagToad in #14553

Dependencies

• chore(deps): bump the codeql-actions group with 3 updates by @dependabot in #14486
• chore(deps): bump nodeselector/setup-apple-codesign from 0.0.2 to 0.0.3 by @dependabot in #14487
• chore(deps): bump charm.land/bubbletea/v2 from 2.0.9 to 2.0.10 by @dependabot in #14541
• chore(deps): bump github.com/klauspost/compress from 1.20.0 to 1.20.1 by @dependabot in #14542
• chore(deps): bump the codeql-actions group with 3 updates by @dependabot in #14543

Full Changelog: v2.101.0...v2.102.0

Linux package repository signing key rotation

GitHub CLI's APT and RPM repositories, along with individual RPM packages, are now signed only with the new PGP key (fingerprint: 7F38BBB59D064DBCB3D84D725612B36462313325)

Important

Linux users who installed gh from the official APT or RPM repositories before April 8, 2026, and have not refreshed their keyring, may now see package installation or update failures. Follow the PGP signing key rotation guidance to check and update your keyring. Users on Windows or macOS, and users who installed gh through Homebrew, GitHub Releases, another package manager, or from source, are not affected.

Copy authentication codes to the clipboard by default

gh auth login and gh auth refresh now copy OAuth device codes to the clipboard by default, saving a manual copy step during authentication.

To persistently opt out, run:

gh config set clipboard disabled

Explicit clipboard options still take precedence for an individual invocation.

What's Changed

✨ Features

• Add clipboard preference for auth flows and default to enabled by @williammartin in #14345

🐛 Fixes

• Use API SSH URLs for repository clones by @williammartin in #14346
• Validate repository names during interactive creation by @sergiou87 in #14313
• Finalize telemetry at invocation completion by @williammartin in #14390
• Record attachment operation counts in telemetry by @BagToad in #14360
• Propagate gh path to extensions by @williammartin in #14282
• Delete repo garden command by @williammartin in #14416
• Fix remote branch deletion for owner case mismatch by @williammartin in #14429
• Retire multi-account migration by @williammartin in #14430

📚 Docs & Chores

• docs: announce Linux PGP key rotation by @babakks in #14340
• Require verified SHAs in issue-triage permalinks by @sergiou87 in #14343
• Add VHS demo skill by @williammartin in #14334
• docs: fix broken "GitHub language" link in primer foundations by @areesh-ali in #14363
• Fix and validate Go bump workflow by @williammartin in #14347
• chore: sign Linux repositories only with the new PGP key by @babakks in #14197
• Rewrite CLI agent guidance by @williammartin in #14388
• Prepare exit errors for Go 1.27 by @williammartin in #14397
• Reduce rate limiting and reduce time taken for acceptance tests by @williammartin in #14320
• Filter acceptance tests for installation token capabilities by @williammartin in #14354
• Fix Go bump workflow authentication by @williammartin in #14412
• Run acceptance tests in Actions with a GitHub App token by @williammartin in #14356
• Fix acceptance script paths on Windows by @williammartin in #14414
• Wait for repository readiness before archiving by @williammartin in #14415
• Update Go bump validation tools by @williammartin in #14428
• Recognize maintainer authorization by @williammartin in #14438
• Safely replace stale Go bump branches by @williammartin in #14441
• Use internal Apple codesign action by @williammartin in #14437
• Test explicit default repository resolution by @williammartin in #14460
• Revert "Use internal Apple codesign action" by @williammartin in #14462

Dependencies

• chore(deps): bump github.com/klauspost/compress from 1.19.2 to 1.20.0 by @dependabot[bot] in #14376
• chore(deps): bump github.com/google/go-containerregistry from 0.22.0 to 0.22.1 by @dependabot[bot] in #14377
• chore(deps): bump github.com/yuin/goldmark from 1.8.5 to 1.8.6 by @dependabot[bot] in #14378
• chore(deps): bump golang.org/x/sync from 0.22.0 to 0.23.0 by @dependabot[bot] in #14391
• chore(deps): bump github.com/microsoft/dev-tunnels from 0.1.27 to 0.2.0 by @dependabot[bot] in #14375
• chore(deps): bump golang.org/x/sys from 0.47.0 to 0.48.0 by @dependabot[bot] in #14417
• Bump Go to 1.27.1 by @github-actions[bot] in #14442
• chore(deps): bump azure/login from 3.0.2 to 3.1.0 by @dependabot[bot] in #14447
• chore(deps): bump the codeql-actions group with 3 updates by @dependabot[bot] in #14446
• chore(deps): bump golang.org/x/term from 0.45.0 to 0.46.0 by @dependabot[bot] in #14445
• chore(deps): bump golang.org/x/text from 0.41.0 to 0.42.0 by @dependabot[bot] in #14444
• chore(deps): bump golang.org/x/crypto from 0.56.0 to 0.57.0 by @dependabot[bot] in #14443
• Bump github.com/cli/go-gh/v2 to v2.16.1 by @niik in #14461

New Contributors

• @areesh-ali made their first contribution in #14363

Full Changelog: v2.100.0...v2.101.0

Experimental: Route GitHub API traffic through a custom host

Organizations can now route a GitHub host's API traffic through a gateway using the new per-host api_host configuration:

# Route API traffic for github.com through a gateway
gh config set api_host gh-gateway.example.com --host github.com
# Read the configured API host
gh config get api_host --host github.com

The original host remains in use for authentication, Git remotes, and browser URLs.

Note

api_host is experimental and is not a security boundary. Requests may still reach the original host.

What's Changed

✨ Features

• Honor per-host api_host routing across GitHub API requests by @williammartin in #14104
• Expose api_host through gh config get and gh config set by @williammartin in #14332
• Add webhook as an official extension by @williammartin in #14326
• Print full command help after command misuse when gh is invoked by a coding agent by @niik in #14198

🐛 Fixes

• fix(api): disable telemetry for unauthenticated GHES requests using absolute hostnames by @williammartin in #14337

📚 Docs & Chores

• Fix discussion acceptance test flags by @williammartin in #14321
• Clarify supported GHES versions by @williammartin in #14324
• Improve automated issue triage analysis by @sergiou87 in #14318
• Record attachment counts in telemetry by @BagToad in #14327

Dependencies

• chore(deps): bump golang.org/x/crypto from 0.55.0 to 0.56.0 by @babakks in #14331
• chore(deps): bump Go toolchain from 1.26.7 to 1.26.8 by @babakks in #14330
• chore(deps): bump github.com/cli/go-gh/v2 from 2.15.0 to 2.16.0 by @williammartin in #14338

Full Changelog: v2.99.0...v2.100.0

Attach images and videos to issues and pull requests

The repeatable --attach flag uploads local images and videos and adds them to issue, pull request, or comment bodies. If a body already references the local path, gh replaces it with the uploaded URL; otherwise it appends the attachment:

# Attach files when creating or editing an issue
gh issue create --attach './repro.png#The error state'
gh issue edit 123 --attach ./walkthrough.mp4

# Attach files when creating or editing a pull request
gh pr create --attach ./before.png
gh pr edit 456 --attach ./after.png

# Attach files to comments
gh issue comment 123 --attach ./repro.png
gh pr comment 456 --attach ./result.mp4

Repeat the flag to attach multiple files in a single invocation. Attachments are available on GitHub.com and GitHub Enterprise Cloud.

For more information see https://gh.io/gh-attach and https://github.blog/changelog/2026-09-01-github-cli-media-in-issues-pull-requests-and-comments/

Worktree support extended to gh issue develop

gh issue develop can now create a linked branch and check it out in a new Git worktree, leaving your current working copy unchanged:

# Create a linked branch for an issue and check it out in a worktree
gh issue develop 123 --checkout --worktree /path/to/wt-feature

What's Changed

✨ Features

Add token and repository metadata required for attachment uploads by @BagToad in #14177

Add validation for attachable image and video files by @BagToad in #14178

Rewrite local Markdown references to uploaded attachment URLs by @BagToad in #14179

Add attachment uploads to GitHub by @BagToad in #14180

Add repeatable --attach flag parsing and upload orchestration by @BagToad in #14181

Add --attach to gh pr comment and gh issue comment by @BagToad in #14182

Add --attach to gh pr create and gh pr edit by @BagToad in #14183

Add --attach to gh issue create and gh issue edit by @BagToad in #14184

Add worktree checkout to gh issue develop by @sergiou87 in #14136

Use text-only spinner output when gh is invoked by a coding agent by @niik in #14191

Honor PI_CODING_AGENT_DIR for Pi user skills by @tommaso-moro in #14260

🐛 Fixes

fix(repo sync): explain when the target branch is checked out in another worktree by @williammartin in #14076

fix(pr merge): safely handle --delete-branch with linked worktrees by @tidy-dev in #14007

fix(copilot): end the declined-install warning with a newline by @BagToad in #14222

fix(attach): clarify retry windows and attachment path resolution by @BagToad in #14262

fix(issue develop): reject non-empty worktree targets before creating a branch by @tidy-dev in #14244

fix(repo sync): prevent linked-worktree corruption by @sergiou87 in #14060

fix(view): reject --comments with --json by @BagToad in #14215

fix(attach): limit batches to 50 files by @BagToad in #14289

fix(skills): install Codex user skills to ~/.agents/skills by @scarletkc in #14154

📚 Docs & Chores

Address review feedback across the --attach stack by @BagToad in #14200

Refactor commands to own attachment flag policy by @BagToad in #14255

Document attachment support in the gh skill by @BagToad in #14261

Document gh issue develop --checkout --worktree in the gh skill by @babakks in #14265

Clarify pull request testing guidance by @williammartin in #14272

Fix issue triage to apply suspected-spam labels directly by @williammartin in #14271

Prevent Dependabot from updating agentic-workflow dependencies by @williammartin in #14274

Modernize Go code with go fix by @BagToad in #14278

Dependencies

chore(deps): bump google.golang.org/grpc from 1.83.0 to 1.83.1 by @dependabot in #14247

chore(deps): bump charm.land/bubbletea/v2 from 2.0.8 to 2.0.9 by @dependabot in #14248

chore(deps): bump the codeql-actions group across 1 directory with 3 updates by @dependabot in #14250

chore(deps): bump charm.land/bubbles/v2 from 2.1.1 to 2.2.0 by @dependabot in #14249

chore(deps): bump agentic-workflows to 0.87.5 by @williammartin in #14273

chore(deps): bump charm.land/bubbles/v2 from 2.2.0 to 2.2.1 by @dependabot in #14275

chore(deps): bump https://github.com/sigstore/protobuf-specs from 0.5.1 to 0.5.2 by @dependabot in #14258

chore(deps): bump https://github.com/google/go-containerregistry from 0.21.9 to 0.22.0 by @dependabot in #14267

chore(deps): bump google.golang.org/grpc from 1.83.1 to 1.83.2 by @dependabot in #14299

chore(deps): bump azure/login from 3.0.1 to 3.0.2 by @dependabot in #14301

chore(deps): bump the codeql-actions group with 3 updates by @dependabot in #14300

New Contributors

@scarletkc made their first contribution in #14154

Full Changelog: v2.98.0...v2.99.0

Security

A security vulnerability has been identified, and fixed, that binds the local forwarded port to all available network interfaces by default.

Users of gh codespace ports forward are advised to update gh to version v2.98.0 as soon as possible.

For more information see: GHSA-vfhh-p7hm-pxfh

Support worktrees in pr checkout

Users can now checkout a pull request into a git worktree by using the new --worktree PATH flag in gh pr checkout:

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

Add semantic search to search issues

The gh search issues command now supports semantic search for issues. Users can select the search type by passing the --search-type flag:

gh search issues --search-type semantic ...
gh search issues --search-type hybrid ...

For more information about semantic search see: "Improved Search for github issues is now generally available".

What's Changed

✨ Features

• Add --worktree flag to gh pr checkout by @tidy-dev in #13946
• Set GH_EXTENSION=1 when gh invokes an extension by @williammartin in #14072
• Add --search-type flag for semantic and hybrid issue search by @michaeljacholke in #14006

🐛 Fixes

• Fix RESTWithNext error type, repairing gh status and attestation retries by @williammartin in #13988
• Trim spaces when parsing X-Oauth-Scopes in gh release create by @williammartin in #14065
• Fix project item-add output for non-TTY by @zwick in #14056

📚 Docs & Chores

• Slim down dependabot triage comments by @williammartin in #14019
• Require explicit PR review ownership by @williammartin in #14028
• Collapse spam triage into the agentic issue-triage workflow by @williammartin in #14027
• Run Dependabot triage every hour by @sergiou87 in #14030
• Route deploy key requests through api.Client by @williammartin in #13989
• Route ssh key requests through api.Client by @williammartin in #13994
• Route gpg key requests through api.Client by @williammartin in #13997
• Route autolink requests through api.Client by @williammartin in #14013
• Route extension requests through api.Client by @williammartin in #14059
• Route release creation through api.Client by @williammartin in #14062
• Tell agents to use the PR template in AGENTS.md by @williammartin in #14074
• Make Dependabot triage cheaper and more decisive by @williammartin in #14079
• Route release deletions through api.Client by @williammartin in #14077
• Give Dependabot triage a real reachability check by @williammartin in #14087
• Restore automatic spam issue closure by @williammartin in #14088
• Add a scheduled tech debt burndown skill by @williammartin in #14095
• Use reflect.Pointer instead of deprecated reflect.Ptr by @williammartin in #14098
• Clarify what belongs in the PR template's testing section by @williammartin in #14103
• Rename cli-code-reviewer skill to code-review by @BagToad in #14116
• Add aw-actions group to dependabot configuration by @babakks in #14123
• Isolate tests from local machine's auth and git configuration by @BagToad in #14128
• Don't ask for feature detection cleanup comments when not needed by @babakks in #14139
• Accept pre-release tags in deployment validation by @BagToad in #14193
• ci: add temporary step to verify Linux repo signing keys by @babakks in #14202
• Revert "ci: add temporary step to verify Linux repo signing keys" by @babakks in #14203
• Fix issue triage action compatibility [skip changelog] by @tidy-dev in #14207

Dependencies

• chore(deps): bump github.com/sigstore/sigstore-go from 1.2.2 to 1.3.0 by @dependabot[bot] in #14047
• chore(deps): bump the codeql-actions group across 1 directory with 3 updates by @dependabot[bot] in #14049
• chore(deps): bump google.golang.org/grpc from 1.82.1 to 1.83.0 by @dependabot[bot] in #14048
• chore(deps): bump github.com/google/go-containerregistry from 0.21.7 to 0.21.8 by @dependabot[bot] in #14066
• chore(deps): bump actions/attest from 4.2.1 to 4.2.2 by @dependabot[bot] in #14100
• chore(deps): bump azure/login from 3.0.0 to 3.0.1 by @dependabot[bot] in #14101
• chore(deps): bump the codeql-actions group across 1 directory with 3 updates by @dependabot[bot] in #14091
• chore(deps): bump github/gh-aw-actions/setup-cli from 0.83.4 to 0.85.4 by @dependabot[bot] in #14068
• chore(deps): bump github.com/google/go-containerregistry from 0.21.8 to 0.21.9 by @dependabot[bot] in #14119
• chore(deps): bump github.com/klauspost/compress from 1.19.1 to 1.19.2 by @dependabot[bot] in #14120
• chore(deps): bump the aw-actions group with 2 updates by @dependabot[bot] in #14147
• chore: sign APT repository with both keys by @babakks in #13271
• chore(deps): bump github.com/yuin/goldmark from 1.8.4 to 1.8.5 by @dependabot[bot] in #14029
• chore(deps): bump actions/attest from 4.2.0 to 4.2.1 by @dependabot[bot] in #14050
• Bump golangci-lint in CI to v2.12.2 by @williammartin in #14102
• chore(deps): bump the aw-actions group with 2 updates by @dependabot[bot] in #14124
• chore(deps): bump google.golang.org/protobuf from 1.36.11 to 1.36.12 by @dependabot[bot] in #14140
• Upgrade gh-aw workflows to v0.85.4 by @tidy-dev in #14141
• Bump Go to 1.26.6 by @github-actions[bot] in #14143
• chore: bump go to 1.26.7 by @babakks in #14205
• chore(deps): bump github.com/stretchr/testify from 1.11.1 to 1.12.1 by @dependabot[bot] in #14204
• chore(deps): bump the codeql-actions group across 1 directory with 3 updates by @dependabot[bot] in #14169
• chore(deps): bump golang.org/x/crypto from 0.54.0 to 0.55.0 by @dependabot[bot] in #14164
• chore(deps): bump charm.land/lipgloss/v2 from 2.0.5 to 2.0.6 by @dependabot[bot] in #14166
• Bump gh-aw-actions to v0.87.1 and recompile agentic workflows by @BagToad in #14210

New Contributors

• @sergiou87 made their first contribution in #14030
• @michaeljacholke made their first contribution in #14006

Full Changelog: v2.97.0...v2.98.0

Security

Four security vulnerabilities have been identified, and fixed, in this release. Users are advised to update gh to version v2.97.0 as soon as possible.

Several commands (including gh gist view, gh api, gh pr diff, gh release download --output -, gh codespace logs, gh skills preview, and gh agent-task view/create) printed externally controlled content without neutralizing terminal escape sequences, allowing escape sequence injection into a user's terminal.

See GHSA-3m3g-3wcr-px46 for more information.

Some request URLs were built without escaping their variable path components, so a value containing URL path metacharacters could alter the request path and cause gh to address a different resource than intended.

See GHSA-4fjg-2h4q-fwg3 for more information.

gh auth status (without --show-token) could print a portion of the authentication token in plaintext for token types whose format contains an underscore after the prefix, such as github_pat_*, ghs_*, and ghu_*.

See GHSA-cg6r-mpgc-h9mm for more information.

gh attestation verify built the certificate matcher from --signer-repo and --signer-workflow without escaping regex metacharacters, so a lookalike repository or workflow name could satisfy a matcher intended for a trusted signer and bypass attestation verification.

See GHSA-mm27-mwq9-fr5g for more information.

Address project fields and items by name in gh project

gh project item-edit and gh project item-list can now reference project fields and single-select options by name:

# Set an item's field by name
gh project item-edit 1 --owner monalisa --url <url> --field "Status" --value "In Progress"
# Show named fields as extra columns
gh project item-list 1 --owner "@me" --field "Status" --field "Priority"

What's Changed

✨ Features

• Add name-based resolution to gh project item-edit by @zwick in #13807
• Add named field columns to gh project item-list by @zwick in #13823
• Add Grok skill host support by @tommaso-moro in #13864
• Replace Windsurf with Devin in gh skill agents by @tommaso-moro in #13987

🐛 Fixes

• Gracefully handle failed GitHub verifier initialization caused by a missing trusted root by @malancas in #13624
• Bump keyring operation timeout from 3s to 60s so interactive unlock prompts have time to complete by @kofuk in #13787
• Fix skill picker label wrapping by @tommaso-moro in #13967

📚 Docs & Chores

• Bump Go to 1.26.5 by @github-actions[bot] in #13817
• Add OWNER/REPO format hint to the gh search --repo flag by @BagToad in #13922
• Present by-name item-edit as the first-class project flow in docs by @Solaris-star in #13927
• Add a macOS keyring security doc by @williammartin in #13960
• Add a code review agent skill by @BagToad in #14003
• Establish a pull request template for scale by @BagToad in #14004
• Add an agentic issue-triage workflow by @lukewar in #13777
• Use the Actions token for Copilot inference in the issue-triage workflow by @tidy-dev in #13830
• Refresh the issue-triage agentic workflow to gh-aw v0.83.1 by @alondahari in #13949
• Add a dependabot-triage agentic workflow by @williammartin in #13985
• Harden the deployment workflow by @niik in #13780
• Replace SITE_DEPLOY_PAT with the gh-cli-site-deployer App by @williammartin in #13492
• Group CodeQL Dependabot updates by @williammartin in #13943
• Remove a dead CODEOWNERS rule for the non-existent pkg/cmd/release/attestation/ by @kobihikri in #13886
• Fix typos in code and documentation by @pstoeckle in #13940
• Fix duplicated-word typos in comments by @SORBELLOSTEFANIE in #13900

Dependencies

• chore(deps): bump charm.land/lipgloss/v2 from 2.0.4 to 2.0.5 by @dependabot in #13790
• chore(deps): bump google.golang.org/grpc from 1.81.1 to 1.82.0 by @dependabot in #13789
• chore(deps): bump https://github.com/klauspost/compress from 1.18.6 to 1.19.0 by @dependabot in #13791
• chore(deps): bump charm.land/bubbletea/v2 from 2.0.7 to 2.0.8 by @dependabot in #13800
• chore(deps): bump golang.org/x/text from 0.38.0 to 0.39.0 by @dependabot in #13812
• chore(deps): bump golang.org/x/sys from 0.46.0 to 0.47.0 by @dependabot in #13821
• chore(deps): bump github/codeql-action/analyze from 4.36.2 to 4.36.3 by @dependabot in #13801
• chore(deps): bump github/gh-aw-actions/setup from 0.81.6 to 0.82.2 by @dependabot in #13832
• chore(deps): bump charm.land/bubbles/v2 from 2.1.0 to 2.1.1 by @dependabot in #13813
• chore(deps): bump golang.org/x/sync from 0.21.0 to 0.22.0 by @dependabot in #13822
• chore(deps): bump github/gh-aw-actions/setup from 0.82.2 to 0.82.3 by @dependabot in #13843
• chore(deps): bump actions/cache/restore from 5.0.5 to 6.1.0 by @dependabot in #13841
• chore(deps): bump golang.org/x/crypto from 0.53.0 to 0.54.0 by @dependabot in #13867
• chore(deps): bump github/codeql-action/analyze from 4.36.3 to 4.37.0 by @dependabot in #13869
• chore(deps): bump github/codeql-action/upload-sarif from 4.36.2 to 4.37.0 by @dependabot in #13868
• chore(deps): bump github/codeql-action/init from 4.36.3 to 4.37.1 by @dependabot in #13870
• chore(deps): bump https://github.com/yuin/goldmark from 1.8.2 to 1.8.4 by @dependabot in #13888
• chore(deps): bump https://github.com/sigstore/sigstore-go from 1.2.1 to 1.2.2 by @dependabot in #13842
• chore(deps): bump github/gh-aw-actions/setup from 0.82.3 to 0.82.8 by @dependabot in #13877
• chore(deps): bump actions/setup-go from 6.5.0 to 7.0.0 by @dependabot in #13933
• chore(deps): bump google.golang.org/grpc from 1.82.0 to 1.82.1 by @dependabot in #13934
• chore(deps): bump actions/setup-node from 6.4.0 to 7.0.0 by @dependabot in #13936
• chore(deps): bump actions/attest from 4.1.1 to 4.2.0 by @dependabot in #13935
• chore(deps): bump https://github.com/mattn/go-isatty from 0.0.22 to 0.0.23 by @dependabot in #13937
• chore(deps): bump github/gh-aw-actions/setup from 0.82.8 to 0.82.13 by @dependabot in #13938
• chore(deps): bump actions/checkout from 7.0.0 to 7.0.1 by @dependabot in #13941
• chore(deps): bump github/codeql-action/upload-sarif from 4.37.0 to 4.37.1 by @dependabot in #13942
• chore(deps): bump https://github.com/gabriel-vasile/mimetype from 1.4.13 to 1.4.14 by @dependabot in #13944
• chore(deps): bump nodeselector/setup-apple-codesign from ab275d0 to 309922b by @dependabot in #13878
• chore(deps): bump https://github.com/klauspost/compress from 1.19.0 to 1.19.1 by @dependabot in #13950
• chore(deps): bump github/gh-aw-actions/setup from 0.82.13 to 0.82.14 by @dependabot in #13951
• chore(deps): bump the codeql-actions group with 3 updates by @dependabot in #13965
• chore(deps): bump https://github.com/mattn/go-isatty from 0.0.23 to 0.0.24 by @dependabot in #13977
• chore(deps): bump the codeql-actions group with 3 updates by @dependabot in #13978
• chore(deps): bump https://github.com/gabriel-vasile/mimetype from 1.4.14 to 1.4.15 by @dependabot in #13976
• chore(deps): bump github/gh-aw-actions/setup from 0.83.1 to 0.83.2 by @dependabot in #13979
• chore(deps): bump github/gh-aw-actions/setup-cli from 0.83.1 to 0.83.2 by @dependabot in #13980
• chore(deps): bump actions/checkout from 6 to 7 by @dependabot in #13981
• chore(deps): bump github/gh-aw-actions/setup from 0.83.2 to 0.83.3 by @dependabot in #13995
• chore(deps): bump github/gh-aw-actions/setup-cli from 0.83.2 to 0.83.3 by @dependabot in #13996
• chore(deps): bump github/gh-aw-actions/setup-cli from 0.83.3 to 0.83.4 by @dependabot in #14018

New Contributors

• @lukewar made their first contribution in #13777
• @niik made their first contribution in #13780
• @kofuk made their first contribution in #13787
• @zwick made their first contribution in #13807
• @kobihikri made their first contribution in #13886
• @pstoeckle made their first contribution in #13940
• @Solaris-star made their first contribution in #13927
• @SORBELLOSTEFANIE made their first contribution in #13900
• @alondahari made their first contribution in #13949

Full Changelog: v2.96.0...v2.97.0

Security

A security vulnerability has been identified, and fixed, that could allow command execution on a user's computer when connecting to a malicious Codespace via gh codespace jupyter.

Users of gh codespace jupyter are advised to update gh to version v2.96.0 as soon as possible.

For more information see: GHSA-8cg3-r6g9-fpg2

Download release assets without authentication

gh release download now works against public repositories without authentication, matching gh extension install. A token is still used when one is present:

# Download assets from a public repository, no login required
gh release download v2.96.0 --repo cli/cli

What's Changed

✨ Features

• Allow gh release download without authentication on public repositories by @BagToad in #13723
• Detect additional third-party coding agents by @BagToad in #13722
• Support antigravity-cli and antigravity2.0 in gh skill by @BagToad in #13784

🐛 Fixes

• fix: show checks summary when all checks were cancelled by @s3onghyun in #13679
• fix(skills): install universal agent to ~/.agents/skills by @toller892 in #13681
• fix(skills): honor --dir without agent prompt by @happysnaker in #13766
• Fix concurrent map writes in codespace port forwarding by @williammartin in #13313
• Use int64 for GitHub database IDs by @williammartin in #13403

📚 Docs & Chores

• Pin reusable triage workflows to a commit SHA by @BagToad in #13705
• Add security disclosure guidance to AGENTS.md by @BagToad in #13720
• Clarify --clone boolean flag behaviour in gh repo fork help by @BagToad in #13786
• Fix flaky TestHuhPrompterMultiSelectWithSearchPersistence on slow architectures by @pdostal in #13675
• docs(search): add examples for multiple qualifiers by @happysnaker in #13756
• docs: fix broken anchor link in release-process-deep-dive by @patrickwehbe in #13688
• docs: fix broken install command and link/grammar errors by @patrickwehbe in #13690
• docs: fix duplicated word in primer README by @s3onghyun in #13677

Dependencies

• chore(deps): bump github.com/microsoft/dev-tunnels from 0.1.19 to 0.1.27 by @dependabot in #13708
• chore(deps): bump actions/checkout from 6.0.3 to 7.0.0 by @dependabot in #13703
• chore(deps): bump github.com/google/go-containerregistry from 0.21.6 to 0.21.7 by @dependabot in #13702
• chore(deps): bump actions/setup-go from 6.4.0 to 6.5.0 by @dependabot in #13740
• chore(deps): bump actions/attest from 4.1.0 to 4.1.1 by @dependabot in #13754
• chore(deps): bump goreleaser/goreleaser-action from 7.2.2 to 7.2.3 by @dependabot in #13759
• chore(deps): bump golangci/golangci-lint-action from 9.2.1 to 9.3.0 by @dependabot in #13779

New Contributors

• @patrickwehbe made their first contribution in #13688
• @s3onghyun made their first contribution in #13679
• @toller892 made their first contribution in #13681
• @happysnaker made their first contribution in #13756

Full Changelog: v2.95.0...v2.96.0

Read repository files and directories with gh repo read-file and gh repo read-dir

Two new preview commands read repository contents without cloning:

# Read a single file to stdout
gh repo read-file README.md --repo cli/cli

# Read from a specific branch, tag, or commit
gh repo read-file go.mod --ref v2.94.0 --repo cli/cli

# Write a file to disk (use --clobber to overwrite)
gh repo read-file README.md --output ./README.md --repo cli/cli

# List the entries in a directory
gh repo read-dir script --repo cli/cli

Both commands default to the repository's default branch, accept --ref to target any branch, tag, or commit, and support --json, --jq, and --template for scripting. This makes it easy for agents and automation to inspect a repo without a full checkout.

Note

gh repo read-file and gh repo read-dir are in preview and subject to change without notice.

What's Changed

✨ Features

• feat: add repo read-file and repo read-dir by @babakks in #13580
• feat(skills): list available skills when install runs non-interactively by @SamMorrowDrums in #13548
• Support custom CLAUDE_CONFIG_DIR in install by @tommaso-moro in #13523

🐛 Fixes

• fix(skills): stage updates in a temp dir and swap in-place by @SamMorrowDrums in #13449

📚 Docs & Chores

• Make filtering by bot authors more discoverable by @BagToad in #13642
• docs(discussion): polish help docs by @babakks in #13632
• Bump Go in devcontainer by @spenserblack in #13674

Dependencies

• chore(deps): bump golang.org/x/text from 0.37.0 to 0.38.0 by @dependabot[bot] in #13640
• chore(deps): bump charm.land/lipgloss/v2 from 2.0.3 to 2.0.4 by @dependabot[bot] in #13663
• chore(deps): bump golang.org/x/term from 0.43.0 to 0.44.0 by @dependabot[bot] in #13661
• chore(deps): bump github/codeql-action from 4.36.1 to 4.36.2 by @dependabot[bot] in #13619
• chore(deps): bump github.com/sigstore/sigstore-go from 1.1.4 to 1.2.1 by @dependabot[bot] in #13662
• chore(deps): bump golang.org/x/crypto from 0.52.0 to 0.53.0 by @dependabot[bot] in #13641

Full Changelog: v2.94.0...v2.95.0

Issue types, sub-issues, and relationships in gh issue

This release brings GitHub's advanced issue features to gh issue create, edit, view, and list. You can set and view an issue's type, organize work with sub-issues, and track blocked-by and blocking relationships without leaving the command line:

# Set an issue's type
gh issue create --type Bug
gh issue edit 123 --type Bug

# Organize work with sub-issues
gh issue create --parent 100
gh issue edit 100 --add-sub-issue 123

# Track blocked-by and blocking relationships
gh issue create --blocked-by 200
gh issue edit 123 --add-blocking 300

Issue types and sub-issues are available on GitHub.com and GHES 3.17+; relationships require GHES 3.19+.

Manage discussions with gh discussion

This release introduces the discussion command set for working with GitHub Discussions in gh:

# List discussions
gh discussion list

# View a discussion, its comments, or replies to a comment
gh discussion view 123 --comments

# Create a discussion
gh discussion create

# Edit a discussion
gh discussion edit 123

# Comment on a discussion
gh discussion comment 123

# Reply to a comment using its URL
gh discussion comment <url>

Run gh discussion --help for more information.

Note

The discussion command set is in preview and is subject to change without notice.

Equip your agents with new gh features

Teach your agents how to leverage new GitHub CLI features on release day by installing the gh skill:

# Install
gh skill install cli/cli gh --scope user

# Or update
gh skill update gh

What's Changed

✨ Features

Add gh discussion command set (list, view, create, edit) as a preview by @babakks and @maxbeizer in #13541

Add gh discussion comment to comment on and reply to discussions by @babakks in #13620

Add Issues 2.0 support: issue types, sub-issues, and relationships by @BagToad in #13057

Add gh skill list to inventory installed agent skills by @tommaso-moro in #13418

Add --all flag to gh skill install to install every skill in a repository by @tommaso-moro in #13471

Skip skills without metadata when running gh skill update --all by @tommaso-moro in #13469

Alias gh extension uninstall to gh extension remove by @BagToad in #13599

Auto-install official extensions in CI by @BagToad in #13581

🐛 Fixes

fix(skill): support skill discovery in nested directories by @tommaso-moro in #13459

📚 Docs & Chores

Bump Go to 1.26.4 by @github-actions[bot] in #13578

Clean up deferred issue update helper by @BagToad in #13584

Add terminal-mockup canvas extension for marketing screenshots by @BagToad in #13612

Add gh discussion and Issues 2.0 reference to the gh skill, plus a README note by @BagToad in #13631

Dependencies

chore(deps): bump golangci/golangci-lint-action from 9.2.0 to 9.2.1 by @dependabot in #13521

chore(deps): bump github.com/gdamore/tcell/v2 from 2.13.9 to 2.13.10 by @dependabot in #13520

chore(deps): bump github.com/mattn/go-colorable from 0.1.14 to 0.1.15 by @dependabot in #13572

chore(deps): bump charm.land/bubbletea/v2 from 2.0.6 to 2.0.7 by @dependabot in #13595

chore(deps): bump github/codeql-action from 4.36.0 to 4.36.1 by @dependabot in #13596

chore(deps): bump actions/checkout from 6.0.2 to 6.0.3 by @dependabot in #13597

Full Changelog: v2.93.0...v2.94.0

Security

A security vulnerability has been identified, and fixed, that would incorrectly include authorization header in API requests to TUF repository mirrors via gh attestation, gh release verify, and gh release verify-asset commands.

Users are advised to update gh to version v2.93.0 as soon as possible.

For more information see: GHSA-8xvp-7hj6-mcj9

Support agents in gh secret command set

The gh secret command set can now set agent secrets. For more information, see "Configuring secrets and variables for Copilot cloud agent".

What's Changed

✨ Features

• Allow agents as application for secrets by @tenjaa in #13421

🐛 Fixes

• fix(pr): remove numberFieldOnly optimization that skips API validation by @williammartin in #13327
• Print gh auth refresh for 401 returns by @333fred in #13068
• Derive digest algorithm from ref length in release verify commands by @bdehamer in #13430

📚 Docs & Chores

• Add missing //go:build integration tag to verify_integration_test.go by @pdostal in #13303
• Fix flaky accessible prompter Password test timeout by @pdostal in #13304
• Enable extended PR screening for external PRs by @tidy-dev in #13312
• Grammar fixes by @scop in #13326
• Bump gh copilot telemetry sampling to 100% by @williammartin in #13362
• Record accessibility feature state in telemetry by @williammartin in #13363
• Poll TTY echo mode instead of sleeping in password tests by @pdostal in #13305
• Switch from actions/attest-build-provenance to actions/attest by @scop in #13325
• Fix skills acceptance tests by @williammartin in #13365
• Bump Go toolchain to 1.26.3 by @Copilot in #13367
• Trigger triage check-requirements on ready_for_review by @BagToad in #13383
• fix(copilot): hint to run copilot directly when exec fails by @babakks in #13393
• Update installation commands for GitHub CLI by @sassdawe in #13126
• Update CODEOWNERS for skills directory ownership by @williammartin in #13416
• fix(telemetry): prevent tzutil console flash on Windows by @adehad in #13353
• Fix bump-go.sh to tolerate missing toolchain directive by @Copilot in #12581
• docs: drop --repo gh-cli from dnf install lines by @c-tonneslan in #13444
• Remove third-party license debris by @williammartin in #13470
• Remove dependency on persistent token by @williammartin in #13474
• Remove discussion workflow by @williammartin in #13476
• Stop bumping homebrew on release by @williammartin in #13479
• build: update golang.org/x/crypto by @tommaso-moro in #13486
• Add 3 day dependabot cooldown period by @williammartin in #13488
• Run govulncheck daily instead of weekly by @williammartin in #13487
• SHA pin first-party GitHub Actions by @williammartin in #13491
• Link to Accessibility category for community discussions instead of ACR by @mxie in #13481
• docs: fix duplicated "of" in release-process-deep-dive by @vip892766gma in #13425
• chore(deps): bump golang.org/x/net from 0.54.0 to 0.55.0 by @BagToad in #13510
• docs: note immutable releases starting v2.93.0 by @BagToad in #13518
• fix CI attestation integration tests after rename by @BagToad in #13536

Dependencies

• chore(deps): bump goreleaser/goreleaser-action from 7.0.0 to 7.2.1 by @dependabot[bot] in #13297
• chore(deps): bump github.com/klauspost/compress from 1.18.5 to 1.18.6 by @dependabot[bot] in #13328
• chore(deps): bump golang.org/x/sys from 0.43.0 to 0.44.0 by @dependabot[bot] in #13381
• chore(deps): bump golang.org/x/term from 0.42.0 to 0.43.0 by @dependabot[bot] in #13396
• chore(deps): bump google.golang.org/grpc from 1.80.0 to 1.81.0 by @dependabot[bot] in #13346
• chore(deps): bump golang.org/x/text from 0.36.0 to 0.37.0 by @dependabot[bot] in #13397
• chore(deps): bump golang.org/x/crypto from 0.50.0 to 0.51.0 by @dependabot[bot] in #13420
• chore(deps): bump google.golang.org/grpc from 1.81.0 to 1.81.1 by @dependabot[bot] in #13436
• chore(deps): bump goreleaser/goreleaser-action from 7.2.1 to 7.2.2 by @dependabot[bot] in #13461
• chore(deps): bump github/codeql-action from 4 to 4.35.5 by @dependabot[bot] in #13489
• chore(deps): bump github.com/theupdateframework/go-tuf/v2 from 2.4.1 to 2.4.2 by @dependabot[bot] in #13462
• chore(deps): bump github.com/google/go-containerregistry from 0.21.5 to 0.21.6 by @dependabot[bot] in #13457

New Contributors

• @pdostal made their first contribution in #13303
• @333fred made their first contribution in #13068
• @scop made their first contribution in #13326
• @sassdawe made their first contribution in #13126
• @adehad made their first contribution in #13353
• @c-tonneslan made their first contribution in #13444
• @tenjaa made their first contribution in #13421
• @mxie made their first contribution in #13481
• @vip892766gma made their first contribution in #13425

Full Changelog: v2.92.0...v2.93.0