gh skill (Public Preview)Agent skills are portable sets of instructions, scripts, and resources that teach AI coding agents how to perform specific tasks. The new gh skill command makes it easy to discover, install, manage, and publish agent skills from GitHub repositories - right from the CLI.
# Discover skills
gh skill search copilot
# Preview a skill without installing
gh skill preview github/awesome-copilot documentation-writer
# Install a skill
gh skill install github/awesome-copilot documentation-writer
# Pin to a specific version
gh skill install github/awesome-copilot documentation-writer --pin v1.2.0
# Check installed skills for updates
gh skill update --all
# Validate and publish your own skills
gh skill publish --dry-run
Skills are automatically installed to the correct directory for your agent host. gh skill supports GitHub Copilot, Claude Code, Cursor, Codex, Gemini CLI, and Antigravity. Target a specific agent and scope with --agent and --scope flags.
gh skill publish validates skills against the Agent Skills specification and checks remote settings like tag protection and immutable releases to improve supply chain security.
Read the full announcement on the GitHub Blog.
gh skill is launching in public preview and is subject to change without notice.
When you run a command that matches a known official extension that isn't installed (e.g. gh stack), the CLI now offers to install it instead of showing a generic "unknown command" error.
This feature is available for github/gh-aw and github/gh-stack.
When possible, you'll be prompted to install immediately. When prompting isn't possible, the CLI prints the gh extension install command to run.
gh extension install no longer requires authenticationgh extension install previously required a valid auth token even though it only needs to download a public release asset. The auth check has been removed, so you can install extensions without being logged in.
gh skill command group: install, preview, search, update, publish by @SamMorrowDrums in https://github.com/cli/cli/pull/13165gh skill publish: auto-push unpushed commits before publish by @SamMorrowDrums in https://github.com/cli/cli/pull/13171gh extension install by @BagToad in https://github.com/cli/cli/pull/13176gh release list --limit 0 by @Bahtya in https://github.com/cli/cli/pull/13097api and auth commands record agentic invocations by @williammartin in https://github.com/cli/cli/pull/13046Full Changelog: https://github.com/cli/cli/compare/v2.89.0...v2.90.0
gh agent-task now works on ghe.com tenanciesgh agent-task commands previously failed with 401 Unauthorized for users on ghe.com tenancy hosts because the Copilot API URL was hardcoded. The URL is now resolved dynamically per host, so gh agent-task works correctly regardless of your GitHub hosting environment.
A new TUI-based prompter powered by charmbracelet/huh is available behind the GH_EXPERIMENTAL_PROMPTER environment variable. This is an early preview — try it out and share feedback!
export GH_EXPERIMENTAL_PROMPTER=1
gh issue create and gh issue transfer no longer require extra token scopesgh issue create and gh issue transfer previously fetched repository fields they didn't need, which could require additional token scopes. These commands now fetch only the minimal fields necessary for issue operations.
gh pr create, gh issue create, gh issue edit: search-based assignee selection and login-based mutation on github.com by @BagToad in #13009GH_EXPERIMENTAL_PROMPTER by @BagToad in #12859issue create and issue transfer by @babakks in #12884gh pr edit --add-reviewer can re-request reviews by @joshjohanning in #13021ApiActorsSupported by @BagToad in #13025Full Changelog: v2.88.1...v2.89.0
pr commands failing with read:project scope errorv2.88.0 introduced a regression where pr commands would fail with the error:
error: your authentication token is missing required scopes [read:project]
To request it, run: gh auth refresh -s read:project
Previously, missing read:project scope was gracefully handled, and project data was silently skipped. A change inadvertently broke the error matching that enabled this graceful degradation. v2.88.1 reverts these changes so that pr commands work correctly without requiring the read:project scope.
Full Changelog: https://github.com/cli/cli/compare/v2.88.0...v2.88.1
ghgh pr create and gh pr edit now support Copilot Code Review as a reviewer. Request a review with --add-reviewer @copilot, or select Copilot interactively from the searchable reviewer prompt.
Create a pull request and request review from Copilot:
gh pr create --reviewer @copilot
Edit a pull request and request review from Copilot:
gh pr edit --add-reviewer @copilot
gh issue close --duplicate-ofYou can now close issues as duplicates and link to a duplicate issue directly from the CLI. The new --duplicate-of flag accepts an issue number or URL and marks the closed issue as a duplicate of the referenced one. You can also use --reason duplicate to set the close reason without linking a specific issue.
# Close as duplicate, linking to the original issue
gh issue close 123 --duplicate-of 456
# Close with duplicate reason only
gh issue close 123 --reason duplicate
gh agent-taskgh agent-task list and gh agent-task view now support --json, --jq, and --template flags, consistent with other gh commands.
gh agent-task list --json id,name,state
gh agent-task view <id> --json state --jq '.state'
gh pr create: login-based reviewer requests and search-based interactive selection by @BagToad in https://github.com/cli/cli/pull/12627gh pr view and gh issue view: show friendly display names for all actors by @BagToad in https://github.com/cli/cli/pull/12854gh issue close: add --duplicate-of flag and duplicate reason by @tksohishi in https://github.com/cli/cli/pull/12811gh pr diff: add --exclude flag to filter files from diff output by @yuvrajangadsingh in https://github.com/cli/cli/pull/12655gh pr view/list: add changeType field to files JSON output by @yuvrajangadsingh in https://github.com/cli/cli/pull/12657gh repo clone: add --no-upstream flag by @4RH1T3CT0R7 in https://github.com/cli/cli/pull/12686gh repo edit: add --squash-merge-commit-message flag by @yuvrajangadsingh in https://github.com/cli/cli/pull/12846gh browse: add --blame flag by @masonmcelvain in https://github.com/cli/cli/pull/11486gh agent-task list: add --json support by @maxbeizer in https://github.com/cli/cli/pull/12806gh agent-task view: add --json support by @maxbeizer in https://github.com/cli/cli/pull/12807gh copilot: set COPILOT_GH env var when launching Copilot CLI by @devm33 in https://github.com/cli/cli/pull/12821gh project item-edit error when editing Draft Issue with only one (--title/--body) flag by @ManManavadaria in https://github.com/cli/cli/pull/12787owner/repo by @Copilot in https://github.com/cli/cli/pull/12836databaseId always being 0 in --json output by @srt32 in https://github.com/cli/cli/pull/12783--remote flag used with repo argument by @majiayu000 in https://github.com/cli/cli/pull/12375gh issue view --comments by @VishnuVV27 in https://github.com/cli/cli/pull/12652gh issue list by @LouisLau-art in https://github.com/cli/cli/pull/12623.git/config corruption on repeated issue develop --name invocation by @gunadhya in https://github.com/cli/cli/pull/12651gh issue close help text by @BagToad in https://github.com/cli/cli/pull/12830prefix in Makefile by @scarf005 in https://github.com/cli/cli/pull/11714api/client.go and project queries by @yuvrajangadsingh in https://github.com/cli/cli/pull/12845StateReason and StateReasonDuplicate feature detection by @BagToad in https://github.com/cli/cli/pull/12838Full Changelog: https://github.com/cli/cli/compare/v2.87.3...v2.88.0
Full Changelog: https://github.com/cli/cli/compare/v2.87.2...v2.87.3
This release was cut primarily to resolve a publishing issue. We recommend reviewing the v2.87.1 release notes for the complete set of latest features and fixes.
Full Changelog: https://github.com/cli/cli/compare/v2.87.1...v2.87.2
The v2.87.1 release experienced a failure in our workflow and is not fully published to the designated package managers/repositories. This is resolved in v2.87.2, so we recommend using that release instead.
Full Changelog: https://github.com/cli/cli/compare/v2.87.0...v2.87.1
gh workflow run immediately returns workflow run URLOne of our most requested features - with the latest changes in GitHub API, gh workflow run will immediately print the created workflow run URL.
gh auth login experience in VM/WSL environmentsWe have observed rare cases of time drift between the wall and monotonic clocks, mostly in WSL or VM environments, causing failures during polling for the OAuth token. This new release implements measures to account for such situations.
If you continue to experience gh auth login issues in WSL, please comment in https://github.com/cli/cli/issues/9370
gh + performance improvementsgh pr edit now supports Copilot Code Review as a reviewer. You can request a review from Copilot using the --add-reviewer @copilot flag or interactively by selecting reviewers in the prompts.
This release also introduces a new search experience for selecting reviewers and assignees in gh pr edit. Instead of loading all collaborators and teams upfront, results are now fetched based on inputs to a new search option. Initial options are suggestions based on those involved with the pull request already.
? Reviewers [Use arrows to move, space to select, <right> to all, <left> to none, type to filter]
[ ] Search (7472 more)
[x] BagToad (Kynan Ware)
> [x] Copilot (AI)
This experience will follow in gh pr create and gh issue for assignees in a later release.
--query flag to project item-list by @williammartin in https://github.com/cli/cli/pull/12696--exit-status with --log and --log-failed in run view by @williammartin in https://github.com/cli/cli/pull/12679gh pr edit: Add support for Copilot as reviewer with search capability, performance and accessibility improvements by @BagToad in https://github.com/cli/cli/pull/12567gh pr edit: new interactive prompt for assignee selection, performance and accessibility improvements by @BagToad in https://github.com/cli/cli/pull/12526gh release upload: Clarify --clobber flag deletes assets before re-uploading by @BagToad in https://github.com/cli/cli/pull/12711gh gist edit command by @BagToad in https://github.com/cli/cli/pull/12710cli/oauth to v1.2.2 by @babakks in https://github.com/cli/cli/pull/12573Full Changelog: https://github.com/cli/cli/compare/v2.86.0...v2.87.0
ghSince we deprecated the GitHub Copilot in the CLI extension in favor of the new agentic GitHub Copilot CLI, we want to give developers using gh a simple way to get started using our most powerful terminal assistant.
gh copilot will prompt to install, then run Copilot CLIgh copilot <args> will execute the Copilot CLI, forwarding any arguments and flagsFor more information and usage options, run gh copilot --help.
gh copilot: add native copilot command to execute/install copilot cli by @devm33 in https://github.com/cli/cli/pull/12444gh cache delete: allow for delete all caches for a ref by @davidspek in https://github.com/cli/cli/pull/12101gh pr create: error when head and base refs are identical in pr create by @majiayu000 in https://github.com/cli/cli/pull/12376copilot command tests by @babakks in https://github.com/cli/cli/pull/12500Full Changelog: https://github.com/cli/cli/compare/v2.85.0...v2.86.0
cli/oauth@v1.2.1 by @babakks in https://github.com/cli/cli/pull/12337v2 by @babakks in https://github.com/cli/cli/pull/12318Full Changelog: https://github.com/cli/cli/compare/v2.83.2...v2.85.0
Full Changelog: https://github.com/cli/cli/compare/v2.83.1...v2.83.2
gh pr edit: Ensure empty arrays for reviewers in PR API calls by @BagToad in https://github.com/cli/cli/pull/12122Full Changelog: https://github.com/cli/cli/compare/v2.83.0...v2.83.1
isImmutable to release list JSON output by @babakks in https://github.com/cli/cli/pull/12064gh agent-task create: support --custom-agent/-a flag by @BagToad in https://github.com/cli/cli/pull/12068--yes is ignored without a repository, Closes: #12033 by @Shion1305 in https://github.com/cli/cli/pull/12039pr revert by @lucasmelin in https://github.com/cli/cli/pull/8826workflow_dispatch to govulncheck triggers by @babakks in https://github.com/cli/cli/pull/12085third-party from Golangci-lint formatting paths by @babakks in https://github.com/cli/cli/pull/12058go fix to remove deprecated // +build tags by @babakks in https://github.com/cli/cli/pull/12056v2.6.0 by @babakks in https://github.com/cli/cli/pull/12049pr checks in run list docs by @babakks in https://github.com/cli/cli/pull/12050gh issue develop branch checkout command by @jonzfisher in https://github.com/cli/cli/pull/12042api command docs around --input and --field by @babakks in https://github.com/cli/cli/pull/12062--interval flags docs in gh pr checks by @2003Aditya in https://github.com/cli/cli/pull/12053Full Changelog: https://github.com/cli/cli/compare/v2.82.1...v2.83.0
gh pr edit not detecting classic projects feature deprecationgh pr edit was not correctly detecting the classic projects API deprecation. This release fixes that detection and avoids an incorrect fetch to the deprecated APIs.
This only impacted gh pr edit commands used to add or remove projects.
gh pr edit: do not fetch V1 projects on unsupported GitHub hosts by @BagToad in https://github.com/cli/cli/pull/11987Full Changelog: https://github.com/cli/cli/compare/v2.82.0...v2.82.1
gh pr edit: Only fetch org teams for reviewers when required by @BagToad in https://github.com/cli/cli/pull/11835gh agent-task create: Fix --follow not killing the progress indicator by @BagToad in https://github.com/cli/cli/pull/11879gh agent-task create: Fix targetting upstream instead of default repo by @BagToad in https://github.com/cli/cli/pull/11896auth login and auth refresh to use UNIX socket by @babakks in https://github.com/cli/cli/pull/11922Full Changelog: https://github.com/cli/cli/compare/v2.81.0...v2.82.0
This release introduces the release verify and release verify-asset commands for verifying GitHub Release attestations. Part of the Immutable Releases initiative, a release attestation provides a signed, timestamped binding between a release, its git tag, and any associated assets. These new commands provide a convenient way to verify the integrity of an immutable release against its attestation.
gh release verifygh release verify v1.2.3gh release verify-asset my-asset.zipgh release verify-asset v1.2.3 my-asset.zipThese commands help ensure that releases and their assets are authentic and haven’t been tampered with, providing an additional layer of security for your software supply chain.
gh auth status Supports JSON OutputThis release adds support for the --json flag in gh auth status. Run gh auth status --help for more information and usage examples.
co for pr checkout by @babakks in https://github.com/cli/cli/pull/11804gh auth status by @benjlevesque in https://github.com/cli/cli/pull/11544release verify and release verify-asset are now visible by @ejahnGithub in https://github.com/cli/cli/pull/11801Full Changelog: https://github.com/cli/cli/compare/v2.80.0...v2.81.0
This GitHub CLI release introduces the agent-task commandset for managing coding agent tasks in gh:
gh agent-task create "refactor the codebase"gh agent-task listgh agent-task view 1234gh agent-task view 1234 --log --followFor more information about command line flags and arguments, run gh agent-task <command> --help.
The agent-task commandset also ships with the following aliases for convenience:
gh agent-tasksgh agentgh agentsℹ️ The agent-task commandset is in preview and is subject to change without notice.
Got feedback? Let us know what you like or don't like in an issue ❤️
gh agent-task commandset by @BagToad and @babakks in https://github.com/cli/cli/pull/11797Full Changelog: https://github.com/cli/cli/compare/v2.79.0...v2.80.0
The GitHub CLI now supports advanced issue search syntax using:
gh search issues <advanced issue search query>gh search prs <advanced issue search query>gh issue list --search <advanced issue search query>gh pr list --search <advanced issue search query>For more information about advanced issue search syntax, see: "Filtering and Searching Issues and Pull Requests"
The GitHub CLI now supports writing the OAuth one-time pass code to the clipboard automatically during authentication:
gh auth login --clipboard / gh auth login -cgh auth refresh --clipboard / gh auth refresh -cgh auth Automatically copy one-time OAuth code to clipboard by @ankddev in https://github.com/cli/cli/pull/11518--ref in gh cache delete by @luxass in https://github.com/cli/cli/pull/11592--generate-notes and --notes-from-tag by @ankddev in https://github.com/cli/cli/pull/11534slices.Equal to simplify code by @minxinyi in https://github.com/cli/cli/pull/11364Full Changelog: https://github.com/cli/cli/compare/v2.78.0...v2.79.0
This release was cut primarily to resolve a Linux package distribution issue. We recommend reviewing the v2.77.0 release notes for the complete set of latest features and fixes.
--force flag to gh run cancel by @ankddev in https://github.com/cli/cli/pull/11513Full Changelog: https://github.com/cli/cli/compare/v2.77.0...v2.78.0
The v2.77.0 release experienced a failure publishing to our official Linux repos. This is resolved in v2.78.0, so we recommend using that release instead.
gh issue view by @andyfeller in https://github.com/cli/cli/pull/11496gh pr view output by @andyfeller in https://github.com/cli/cli/pull/11497gh repo delete --yes safety issue when no repository argument provided by @Copilot in https://github.com/cli/cli/pull/11536help wanted label regexp in CI automation by @babakks in https://github.com/cli/cli/pull/11423gh search docs to explain the usage of -- to exclude certain results by @Sukhpreet-s in https://github.com/cli/cli/pull/11162Full Changelog: https://github.com/cli/cli/compare/v2.76.2...v2.77.0