No entries match these filters. Clear filters
GitHub CLI adds gh event command set to subscribe to and listen for GitHub Event Streams Event Streams An ordered, append-only log of discrete events published by producers and consumed by subscribers, often in real time; tools use it to process high-volume telemetry without losing ordering or dropping records under load. without polling Preview ︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.105.0 https://github.com/cli/cli.git
$ git checkout v2.105.0
└──▷ TRY IT
Block a CI script until a pull request review is submitted, then extract the conclusion — avoiding repeated API polling.
copy
$ gh event listen --resource https://github.com/OWNER/REPO/pull/NUMBER --event com.github.pull_request.review.submitted.v1 --timeout 30m
Wait for a check suite to finish and print only its conclusion, useful for gating a deployment step on CI passing.
copy
$ gh event listen --resource https://github.com/OWNER/REPO/pull/NUMBER --event com.github.pull_request.check_suite.status.changed.v1 --jq .data.conclusion
Inspect all active event subscriptions to audit what an agent or script is currently listening to.
copy
$ gh event subscription list
Wait for specific pull request events without polling using gh event listen --resource <url> --event <event-type>, with --timeout, --count, or --follow flags to control how long to wait; events are printed as CloudEvent JSON objects with data.api_url pointing to the changed resource.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Manage event subscriptions directly with gh event subscription create, gh event subscription list, gh event subscription view, and gh event subscription delete. Not checked yet Get suggestions to use gh event listen for check suite events from within gh run view and gh run watch. Not checked yet
Wait for specific pull request events without polling using gh event listen --resource <url> --event <event-type>, with --timeout, --count, or --follow flags to control how long to wait; events are printed as CloudEvent JSON objects with data.api_url pointing to the changed resource.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Manage event subscriptions directly with gh event subscription create, gh event subscription list, gh event subscription view, and gh event subscription delete. Not checked yet
1 more in Everything
GitHub CLI adds --accept-cascading-deletion-of-private-forks to gh repo delete to guard against accidental fork loss︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.104.0 https://github.com/cli/cli.git
$ git checkout v2.104.0
└──▷ TRY IT
Delete a private repo that has private forks non-interactively in a CI or agent workflow without manual prompts.
copy
$ gh repo delete OWNER/REPO --yes --accept-cascading-deletion-of-private-forks
Protect private forks from accidental deletion by confirming cascade warnings in gh repo delete with the new --accept-cascading-deletion-of-private-forks flag for non-interactive and agent workflows.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet
1 detail in Everything
└──▷ BREAKING ON UPGRADE
!
`gh repo delete --yes` on a private or internal repository with forks now requires the additional `--accept-cascading-deletion-of-private-forks` flag to proceed non-interactively; existing scripts that pass only `--yes` will stall waiting for confirmation.
Our best guess
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 token access token A 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 tokens access tokens A 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 tokens refresh tokens A 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.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Adds --no-refresh flag to gh auth token to print the current token without triggering a refresh. Not checked yet 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. Not checked yet 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). Not checked yet Adds GH_ENTERPRISE_TOKEN environment variable for authenticating to GitHub Enterprise Server in non-interactive and GitHub Actions GitHub Actions GitHub'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. Not checked yet
+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. Not checked yet 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. Not checked yet
Adds --expiring flag to gh auth login to request short-lived access tokens access tokens A 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 tokens refresh tokens A 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.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Adds --no-refresh flag to gh auth token to print the current token without triggering a refresh. Not checked yet Adds GH_ENTERPRISE_TOKEN environment variable for authenticating to GitHub Enterprise Server in non-interactive and GitHub Actions GitHub Actions GitHub'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. Not checked yet 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. Not checked yet
3 more in Everything
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
$ 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.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Adds expiring_credentials enabled setting to gh config set to prefer expiring credentials for every sign-in globally. Not checked yet gh auth status now shows whether a credential is refreshable and the relative time until the current access token access token A 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. Not checked yet 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 . Not checked yet Adds --attach flag to gh issue artifact create to attach images or video files to Markdown documents. Not checked yet
+3 more
show less
Adds --body-file flag to gh issue artifact edit to update a document's content from a file. Not checked yet Adds --restore-version flag to gh issue artifact edit to roll back an artifact to an earlier version. Not checked yet Replaces gh extension browse with a Bubble Tea TUI TUI A 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. . Not checked yet
Adds --expiring flag to gh auth login to sign in with short-lived, auto-refreshing OAuth credentials that rotate without requiring re-authentication.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Adds expiring_credentials enabled setting to gh config set to prefer expiring credentials for every sign-in globally. Not checked yet 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 . Not checked yet Adds --attach flag to gh issue artifact create to attach images or video files to Markdown documents. Not checked yet Adds --body-file flag to gh issue artifact edit to update a document's content from a file. Not checked yet
+1 more
show less
Adds --restore-version flag to gh issue artifact edit to roll back an artifact to an earlier version. Not checked yet
2 more in Everything
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
$ 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
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
$ 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. Not checked yet Adds webhook as an official built-in extension. Not checked yet Prints full command help when gh is invoked by a coding agent after command misuse, improving agent-driven workflows. Not checked yet
3 details in Everything
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. Not checked yet Supports repeating --attach multiple times in a single command to attach more than one file (attaching the same file twice is not allowed). Not checked yet 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. Not checked yet 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. Not checked yet Requires push access to the repository to attach files. Not checked yet
5 details in Everything
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
$ 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. Not checked yet 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. Not checked yet Outputs text-only spinner output when gh is invoked by a coding agent, improving agent-readable output. Not checked yet
3 details in Everything
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)︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet
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
$ 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 search hybrid search Combining 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. Not checked yet Adds --search-type flag to gh search issues supporting semantic and hybrid search modes. Not checked yet Sets GH_EXTENSION=1 environment variable when gh invokes an extension, allowing extensions to detect they were launched by gh. Not checked yet
3 details in Everything
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)︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet
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)︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet
advisory CVE-2026-64654
Jul 31, 2026
·
issue 128
CVE-2026-64654: Terminal escape sequence injection in multiple gh commands (affects <= v2.96.0)︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet
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
$ 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. Not checked yet Adds --field flag to gh project item-list to display named project fields as extra columns in output. Not checked yet Adds Grok skill host support to gh skill agent integrations. Not checked yet Replaces Windsurf with Devin in the gh skill agent roster. Not checked yet
4 details in Everything
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 (CVSS CVSS Common 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)︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet
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
$ 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. Not checked yet gh skill now supports antigravity-cli and antigravity2.0. Not checked yet gh skill detects additional third-party coding agents. Not checked yet
3 details in Everything
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
$ 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. Not checked yet Introduces gh repo read-dir to list directory entries in a repository without cloning. Not checked yet Both new commands support --ref to target specific branches, tags, or commits and --json, --jq, --template for scripting. Not checked yet
3 details in Everything
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
$ 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.
gh discussion list — List discussions Not checked yet gh discussion view <id> --comments — View a discussion with its comments Not checked yet gh discussion create — Create a new discussion Not checked yet gh discussion edit <id> — Edit an existing discussion Not checked yet gh discussion comment <id> — Add a comment to a discussion Not checked yet
+8 more
show less
gh discussion comment <url> — Reply to a specific comment via its URL Not checked yet gh issue create --type <Type> — Set the type of a new issue Not checked yet gh issue edit <id> --type <Type> — Change the type of an existing issue Not checked yet gh issue create --parent <parentId> — Link a new issue to a parent Not checked yet gh issue edit <id> --add-sub-issue <subIssueId> — Add a sub-issue link on an existing issue Not checked yet gh issue create --blocked-by <issueId> — Set a blocked by relationship during creation Not checked yet gh issue edit <id> --add-blocking <blockingId> — Set a blocking relationship on an existing issue Not checked yet gh skill list — List installed agent skills Not checked yet
13 details in Everything
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 (CVSS CVSS Common 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)︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet
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
$ git checkout v2.93.0
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
$ 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. Not checked yet 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/. Not checked yet
2 details in Everything
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
$ git checkout v2.91.0
└──▷ USE IT
View collected telemetry data without leaving the CLI.
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 Not checked yet Adds --allow-hidden-dirs flag to gh skill install to discover skills in dot-prefixed directories like .claude/skills/ and .agents/skills/ Not checked yet Adds --upstream flag to gh skill install to support non-interactive installation of skills detected as re-published from an upstream source Not checked yet
3 details in Everything
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
$ 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. Not checked yet Adds --pin <version> flag to gh skill install to pin a specific version of an agent skill instead of using the default latest release. Not checked yet 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. Not checked yet Enables gh extension install without requiring authentication when installing public extensions that do not need auth to access their release assets. Not checked yet Adds smart suggestions for official extensions (like gh stack) when running an unknown command, prompting the user to install the matching official extension. Not checked yet
5 details in Everything
gh agent-task supports ghe.com; new TUI TUI A 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
$ 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. Not checked yet gh pr create, gh issue create, and gh issue edit now support search-based assignee selection on github.com. Not checked yet
2 details in Everything
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
$ 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 Not checked yet gh issue close gains --duplicate-of flag to link a closed issue to another issue, and supports --reason duplicate Not checked yet gh agent-task list and gh agent-task view support --json, --jq, and --template flags for programmatic output Not checked yet gh pr diff adds --exclude flag to filter files from diff output Not checked yet gh pr view/list adds changeType field to files JSON output Not checked yet
+3 more
show less
gh repo clone supports new --no-upstream flag Not checked yet gh repo edit gains --squash-merge-commit-message flag Not checked yet gh browse supports new --blame flag Not checked yet
8 details in Everything
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
$ 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 Not checked yet Adds --query flag to gh project item-list for filtering items Not checked yet gh workflow run now immediately prints the created workflow run URL Not checked yet
3 details in Everything
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
$ git checkout v2.86.0
Adds gh copilot subcommand to install and execute the GitHub Copilot CLI agent. Not checked yet gh cache delete now supports deleting all caches for a specific ref. Not checked yet
2 details in Everything
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
$ 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. Not checked yet Allows gh repo set-default to accept git remote names instead of just URLs. Not checked yet
2 details in Everything
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
$ 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. Not checked yet Adds isImmutable field to the JSON output of release list. Not checked yet Introduces the gh pr revert subcommand for reverting pull requests. Not checked yet
3 details in Everything
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
$ 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 Not checked yet Add JSON output to gh auth status Not checked yet
2 details in Everything
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
$ 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> Not checked yet gh agent-task list Not checked yet gh agent-task view <id> [--log] [--follow] Not checked yet
3 details in Everything
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
$ 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 Not checked yet Adds --clipboard (-c) flag to gh auth login and gh auth refresh to automatically copy the OAuth one-time pass code to the clipboard Not checked yet Adds advanced issue search query support via --search flag in gh search issues, gh search prs, gh issue list, and gh pr list Not checked yet
3 details in Everything
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
$ 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. Not checked yet
1 detail in Everything
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
$ git checkout v2.77.0
gh issue view displays GitHub Project (v2) data in its output Not checked yet gh pr view displays GitHub Project (v2) data in its output Not checked yet
2 details in Everything
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
$ 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
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
$ git checkout v2.75.0
Adds --no-repos-selected flag to gh secret set to handle secret operations when no repository context is active Not checked yet
1 detail in Everything
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
$ git checkout v2.74.0
└──▷ TRY IT
Initialize a new workflow setup via an interactive TUI TUI A 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 Actions GitHub Actions GitHub'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 Not checked yet Adds --compact flag to gh run watch to produce terse, line-drawing output suitable for constrained terminals Not checked yet Enhances gh attestation commands with retry logic when fetching Trusted Uniform Format (TUF) content to improve reliability Not checked yet
3 details in Everything
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
$ 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. Not checked yet gh pr edit supports --add-assignee @copilot to assign the GitHub Copilot coding agent to a pull request. Not checked yet 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 ). Not checked yet JSON output from gh issue view now includes the closedByPullRequestsReferences field. Not checked yet
4 details in Everything
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
$ git checkout v2.72.0
└──▷ TRY IT
Explore the new accessible features via CLI help
gh accessibility help topic introduces customizable contrasting colors, non-interactive user input prompting, and text-based spinners for accessibility. Not checked yet
1 detail in Everything
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
$ 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. Not checked yet Introduces option to opt-out of spinners in the CLI. Not checked yet gh config: adds config settings for accessible prompter and disabling spinner. Not checked yet
3 details in Everything
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
$ git checkout v2.70.0
Introduces accessible prompter for screen readers Preview Not checked yet Adds experimental support for rendering markdown with customizable, accessible colors Not checked yet
2 details in Everything
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
$ 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 Not checked yet Commands accepting filepath arguments now support glob expansion for * characters Not checked yet
2 details in Everything
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
$ 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. Not checked yet gh pr checkout passes the new --no-tags flag to git fetch, skipping tag updates during checkout. Not checked yet 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. Not checked yet 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. Not checked yet gh release create now fails if there are no new commits since the last release, preventing empty releases. Not checked yet
+1 more
show less
Forking a repo during PR creation (via gh pr create) now automatically updates the default upstream remote. Not checked yet
6 details in Everything
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 (CVSS CVSS Common 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)︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet
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
$ git checkout v2.67.0
gh pr checkout now prompts interactively to select a pull request when no ID or branch is provided Not checked yet
1 detail in Everything
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
$ 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. Not checked yet gh secret list, gh secret set, and gh secret delete now require explicit repository selection via -R, --repo when multiple git remotes are present. Not checked yet Extension update notices can be disabled globally by setting the GH_NO_EXTENSION_UPDATE_NOTIFIER environment variable. Not checked yet Windows MSI installers now support the arm64 architecture, enabled via new build targets. Not checked yet
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.
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
$ git checkout v2.65.0
└──▷ TRY IT
Enable secret scanning secret scanning Checking 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. Not checked yet gh run list displays a pending state for workflow runs that have not yet started. Not checked yet
2 details in Everything
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
$ git checkout v2.64.0
└──▷ TRY IT
Verify an attestation by fetching the bundle directly from an OCI OCI Open 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 OIDC OIDC OpenID 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 Not checked yet gh attestation verify prints policy information before performing verification Not checked yet
2 details in Everything
advisory CVE-2024-54132
Dec 3, 2024
·
issue 128
CVE-2024-54132: Downloading malicious GitHub Actions GitHub Actions GitHub'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)︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet
advisory CVE-2024-53858
Nov 27, 2024
·
issue 128
CVE-2024-53858: Recursive repository cloning can leak authentication tokens to non-GitHub submodule hosts (CVSS CVSS Common 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)︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet
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
$ 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 Not checked yet Enables creation of repositories without an initial commit via bare repo support in repo create Not checked yet
2 details in Everything
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
$ git checkout v2.62.0
Notifies users when a new version of an installed gh extension is available Not checked yet Shortens extension release checking timeout from 3s to 1s Not checked yet
2 details in Everything
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
$ 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 Not checked yet
1 detail in Everything
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
$ 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 Not checked yet Adds filtering support to the gist list command Not checked yet Makes markdown WithWrap() max width configurable Not checked yet
3 details in Everything
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
$ 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 OIDC OIDC OpenID 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 providers identity providers A service that authenticates users and supplies identity information to other applications. It is the sign-in authority behind many single sign-on systems. . Not checked yet gh auth status accepts a new --active flag to filter output and show only active authentication sessions. Not checked yet
2 details in Everything
gh attestation verify gains OCI OCI Open 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
$ git checkout v2.56.0
Fetches the attestation bundle from an OCI registry for gh attestation verify Not checked yet
1 detail in Everything
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
$ 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 Not checked yet Requires Sigstore Bundle format version 0.2+ when verifying attestation bundles with gh attestation verify Not checked yet Changes gh search project filter syntax from --project <number> to --project owner/number Not checked yet
3 details in Everything
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
$ 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 Not checked yet Expose databaseId JSON field for release commands (e.g., gh release view --json databaseId) Not checked yet Expose fullDatabaseId JSON field for PR JSON export (e.g., gh pr view --json fullDatabaseId) Not checked yet Add --bare support to clone targets in gh repo clone Not checked yet
4 details in Everything
└──▷ BREAKING ON UPGRADE
! The CLI now exits with code 1 (instead of the previous exit code) on authentication issues.
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
$ 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 Not checked yet Adds --json option to variable get command for machine-readable output Not checked yet Adds pr update-branch command to update pull request branches Not checked yet Adds issue create --editor flag to open the system editor for issue creation Not checked yet
4 details in Everything
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
$ 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. Not checked yet
1 detail in Everything
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
$ git checkout v2.51.0
└──▷ USE IT
Verify an artifact's provenance provenance Evidence 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 Actions GitHub Actions GitHub'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.
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
$ 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. Not checked yet feat: add json output for gh pr checks by adding --json flag support to retrieve check run details in structured format. Not checked yet
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.
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
$ git checkout v2.49.0
└──▷ USE IT
Verify the provenance provenance Evidence 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 OCI OCI Open 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://...). Not checked yet Adds gh attestation download to retrieve cryptographically signed metadata (attestations) for built artifacts. Not checked yet Enables offline verification mode via a dedicated offline path for gh attestation verify. Not checked yet
3 details in Everything
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
$ git checkout v2.48.0
Added --skip-ssh-key option to gh auth login command Not checked yet Added support for --slurping JSON responses in gh api Not checked yet Added numSelectedRepos to JSON output of gh secret list Not checked yet Added support for multiple items in gh api nested array Not checked yet
4 details in Everything
Introduces gh-attestation subcommand for inspecting software supply chain software supply chain The 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
$ 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. Not checked yet Upgrades the project to Go 1.22. Not checked yet
2 details in Everything
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
$ 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. Not checked yet project item-list output now includes draft issue IDs in the JSON response. Not checked yet
2 details in Everything
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
$ git checkout v2.45.0
└──▷ USE IT
Filter GitHub Actions GitHub Actions GitHub'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 Not checked yet Supports TTY output for project view --web, allowing interactive terminal interaction when opening project views Not checked yet
2 details in Everything
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
$ 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 Not checked yet Adds --cache-key option to gh cache list for filtering caches by key Not checked yet Enables auto-filling pull request body when creating PRs via CLI Not checked yet
3 details in Everything
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
$ 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 Not checked yet Adds --json flag to gh release list to export releases in structured JSON format Not checked yet Outputs the repository URL when creating a new repo via gh repo create Not checked yet
3 details in Everything
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
$ 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. Not checked yet
1 detail in Everything
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
$ 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 Not checked yet New gh auth switch subcommand allows manual switching between configured accounts for both gh CLI and git operations Not checked yet gh auth status output enhanced to display multiple configured accounts simultaneously Not checked yet Commit SHA filtering added to gh run list command for precise workflow run identification Not checked yet gh pr merge interactive mode now provides more informative output during merge operations Not checked yet
5 details in Everything
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
$ git checkout v2.39.2
└──▷ USE IT
Sync a local feature branch to track its corresponding upstream branch.
shell
copy
gh repo sync --upstream
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
$ git checkout v2.39.0
issue/pr: Include project item status when exporting issues and pull requests Not checked yet api: Set default Accept header when one is not specified Not checked yet
2 details in Everything
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
$ git checkout v2.38.0
workflow run now presents a select for choice workflow input types Not checked yet All tables in GitHub CLI output now have headers Not checked yet
2 details in Everything
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
$ 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 Not checked yet repo create: Allow creating repositories from templates in interactive mode Not checked yet codespace create: Poll permission acceptance endpoint on codespace creation Not checked yet project: Remove template field from --format=json output Not checked yet repo fork: Set default repo when forking repo Not checked yet
5 details in Everything
└──▷ BREAKING ON UPGRADE
! The template field is removed from the JSON output (--format=json) of project commands
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
$ git checkout v2.36.0
codespace ports: Forward codespace ports over Dev Tunnels Not checked yet cache list / secret list / deploy-key list: Add support for standard output format flags (e.g. JSON) Not checked yet project item-edit: New --clear flag to remove item field value Not checked yet
3 details in Everything
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
$ 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 Not checked yet Adds --cleanup-tag flag to gh release delete to automatically remove associated Git tags Not checked yet Adds --notes-from-tag flag to gh release create to populate release notes from an existing tag's description Not checked yet
3 details in Everything
GitHub CLI v2.34.0 adds config clear-cache command, --verbose to api, and structured output structured output Forcing 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
$ 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. Not checked yet api: Adds the --verbose flag for detailed API response logging. Not checked yet workflow list: Adds --json, --jq, and --template flags for structured output. Not checked yet project mark-template: New subcommand to control project template options. Not checked yet
4 details in Everything
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
$ 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. Not checked yet Adds missing ls aliases to list subcommands, enabling gh ruleset ls shorthand syntax. Not checked yet Allows using the --org parameter in lieu of a repo context for rulesets subcommands. Not checked yet
3 details in Everything
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
$ 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 Not checked yet Adds gh cache command to list and delete GitHub Actions GitHub Actions GitHub'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 Not checked yet Adds --fill-first flag to gh pr create to populate the PR title from the commit message Not checked yet Adds --server-port=0 support to Codespaces commands for random port allocation and connection details display Not checked yet Adds --verify-tag option to gh release edit to validate tag existence Not checked yet
5 details in Everything
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
$ 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 Not checked yet search code command for code search from the CLI Not checked yet api REST pagination outputs a single JSON array Not checked yet
3 details in Everything
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
$ 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 Not checked yet Support for nested aliases Not checked yet
2 details in Everything
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
$ 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 Not checked yet pr status: display auto-merge information Not checked yet
2 details in Everything
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
$ git checkout v2.28.0
└──▷ TRY IT
List all organizations visible to the current user.
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. Not checked yet issue edit: allows editing multiple issues at the same time. Not checked yet ssh-key: adds ability to manage signing keys in addition to regular SSH keys. Not checked yet search: enables the --owner flag to take multiple values. Not checked yet codespace list and codespace create add a --web flag. Not checked yet
+2 more
show less
run list adds --event and --created filters. Not checked yet repo output now includes a visibility JSON field. Not checked yet
7 details in Everything
└──▷ BREAKING ON UPGRADE
! macOS release archives changed from .tar.gz to .zip format.
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
$ 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
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
$ 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 Not checked yet Adds --template flag to gh issue create and gh pr create for specifying issue/PR templates Not checked yet Adds --fail-fast option to gh pr checks --watch to stop watching on the first check failure Not checked yet Allows filtering workflow runs by status via a new flag in gh run list or similar subcommands Not checked yet Adds support for renaming gists directly from the CLI (gh gist rename) Not checked yet
+1 more
show less
gh run view gains an --attempt argument to inspect specific workflow run attempts Not checked yet
6 details in Everything
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
$ 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 Not checked yet Adds a --force flag to the ext install command Not checked yet
2 details in Everything
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
$ 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. Not checked yet Adds gh repo unarchive command to unarchive a repository directly from the CLI. Not checked yet Introduces GH_PATH environment variable to override the default configuration directory location. Not checked yet Adds --releases option to gh browse to navigate directly to the releases page. Not checked yet Extends gpg-key add with a --title argument to assign a custom name to the uploaded GPG key. Not checked yet
5 details in Everything
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
$ git checkout v2.23.0
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
$ git checkout v2.22.1
Renames the --confirm flag to --yes for various destructive commands, replacing the previous long-form option. Not checked yet
1 detail in Everything
└──▷ BREAKING ON UPGRADE
! The --confirm flag has been removed; use --yes instead.
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
$ 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 Not checked yet Enables --project <name> flag on gh issue create and gh pr create for GitHub Projects (v2) requiring the project OAuth scope Not checked yet Adds --enable-discussions option to gh repo edit to toggle repository discussions Not checked yet Makes gh auth status display the current token's OAuth scopes Not checked yet Causes gh extension create to automatically make the initial git commit Not checked yet
5 details in Everything
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
$ 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 Not checked yet Enables nested JSON parameters in gh api via bracket syntax (e.g., -f 'head[branch][name]=main', -f 'labels[]=bug') Not checked yet Adds issue lock and pr lock subcommands to lock issues and pull requests Not checked yet Adds issue unlock and pr unlock subcommands to unlock issues and pull requests Not checked yet Adds --verify-tag flag to gh release create Not checked yet
+3 more
show less
Adds --exclude-pre-releases flag to gh release create Not checked yet Adds --allow-update-branch flag to gh repo edit Not checked yet Allows setting display name in gh codespace create Not checked yet
8 details in Everything
└──▷ BREAKING ON UPGRADE
! codespace create and other Codespaces commands now require -R for the repo shorthand; -r is deprecated.
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
$ 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 Not checked yet Adds gh extension search to find repositories with the gh-extension topic Not checked yet
2 details in Everything
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
$ 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 Not checked yet Introduces gh issue develop subcommand for managing branches linked to issues Not checked yet gh release download gains --output flag to specify output location for a single asset Not checked yet gh repo list --topic now accepts multiple topics in a single invocation Not checked yet gh codespace rebuild performs incremental rebuilds by default, with --full for complete rebuilds Not checked yet
+4 more
show less
gh extension upgrade accepts --force to override the pinned state of extensions Not checked yet gh run list JSON export includes a new number field Not checked yet gh run view JSON export includes a new jobs field Not checked yet gh pr create can now be used from outside a local git repository when -R and -H are specified Not checked yet
9 details in Everything
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
$ git checkout v2.18.0
└──▷ USE IT
Rebuild an existing Codespace configuration without destroying the machine
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 Not checked yet Adds the ssh-key delete subcommand to remove SSH keys via CLI Not checked yet Adds the gpg-key delete subcommand to remove GPG keys via CLI Not checked yet Adds --cleanup-tag flag to release delete to remove associated tags Not checked yet Adds --edit-last flag to issue/pr comment for editing the most recent comment Not checked yet
+1 more
show less
Adds --web flag to pr diff to open the diff in a browser instead of the terminal Not checked yet
6 details in Everything
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
$ git checkout v2.17.0
└──▷ TRY IT
Export your personal access token personal access token A 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.
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. Not checked yet New --email flag for gh pr merge to set the commit author email. Not checked yet gh pr status now displays merge conflict information. Not checked yet gh gpg-key list output includes a header row. Not checked yet
4 details in Everything
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
$ 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 Not checked yet auth login and repo delete now respect the GH_HOST environment variable for host targeting Not checked yet
2 details in Everything
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
$ 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 Not checked yet pr checks adds the --required flag to filter for required status checks Not checked yet issue close supports --reason "not planned" for closing issues with that specific reason Not checked yet run list --json output includes new displayTitle and workflowName fields Not checked yet pr ready gains an --undo option to revert a PR back to draft state Not checked yet
5 details in Everything
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
$ 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 Not checked yet Adds --clobber flag to release download to overwrite existing files Not checked yet Adds --skip-existing flag to release download to skip already-downloaded assets Not checked yet Adds --notes-start-tag parameter to release create to define the start of release notes Not checked yet Exposes repository name without owner prefix in search command output Not checked yet
5 details in Everything
└──▷ BREAKING ON UPGRADE
! The Linux installation GPG signing key has been rotated; existing downloaded keys must be replaced.
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
$ 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 Not checked yet Enables GH_PROMPT_DISABLED environment variable to disable interactive prompting in the CLI Not checked yet Adds age field to pr list and pr view output for pull request age information Not checked yet Allows use of environmental variables inside --jq expressions on commands that support JSON filtering Not checked yet
4 details in Everything
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
$ 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 Not checked yet Changes the default behavior of run download to allow retrieving more than 100 artifacts Not checked yet
2 details in Everything
New pr merge --match-head-commit, codespace org management, and ARM ARM A 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
$ 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 Not checked yet Add --retention-period flag to gh codespace create to control lifecycle Not checked yet Add --org flag to gh codespace list, stop, and delete for admin workflows Not checked yet Auto-generate SSH keys in gh codespace ssh instead of requiring pre-existing keys Not checked yet Notify users in gh codespace create when usage is covered by an organization Not checked yet
+2 more
show less
Allow gh secret set to configure repository secrets scoped to Codespaces Not checked yet Distribute Windows ARM precompiled binary and support arm64 extensions Not checked yet
7 details in Everything
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
$ 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. Not checked yet codespace edit supports interactive mode to select from a list of codespaces. Not checked yet
2 details in Everything
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
$ 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 Not checked yet auth login: Add ability to set title for ssh key Not checked yet repo clone: Add --upstream-remote-name flag Not checked yet repo create: Add --include-all-branches flag Not checked yet run download: Add --pattern flag Not checked yet
+1 more
show less
run rerun: Add --debug flag Not checked yet
6 details in Everything
└──▷ BREAKING ON UPGRADE
! secrets remove command renamed to secrets delete
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
$ 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. Not checked yet label remove command added to delete repository labels. Not checked yet label list --json output format added for machine-readable label data. Not checked yet repo list --visibility=internal flag added to filter lists to internal repositories only. Not checked yet release list --exclude-drafts flag added to omit draft releases from listing. Not checked yet
+1 more
show less
codespace jupyter command added to open codespaces in JupyterLab. Not checked yet
6 details in Everything
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
$ 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 Not checked yet label clone: Command to clone labels between repositories Not checked yet label create: Add --force flag to forcibly create labels Not checked yet codespaces: Support for multi devcontainer Not checked yet
4 details in Everything
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
$ 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. Not checked yet Adds the --comment flag to the issue close subcommand, allowing users to attach a comment when closing an issue via CLI. Not checked yet Adds the --confirm flag to the issue delete subcommand to skip the confirmation prompt when deleting issues programmatically. Not checked yet Adds the --web flag to the codespace code subcommand to open the codespace in Visual Studio Code web mode. Not checked yet Makes the location argument optional in the codespace create command, enabling default workspace creation without specifying a region. Not checked yet
+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. Not checked yet Allows non-interactive file replacement in the gist edit command for scripted workflows. Not checked yet Enables binary extension installation on M1 Macs, expanding supported platforms for third-party extensions. Not checked yet
8 details in Everything
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
$ 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.
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 Not checked yet gh search issues and gh search pull-requests subcommands for searching across repositories Not checked yet label list and label create commands for managing labels directly from the CLI Not checked yet Ability to filter issue and pull request lists by application (e.g., Dependabot, Renovate) Not checked yet extension install now supports pinning extensions to a specific version via a new option Not checked yet
+2 more
show less
Support for Dependabot secrets allows automated dependency updates within GitHub Actions GitHub Actions GitHub'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 Not checked yet New GH_DEBUG environment variable replaces the deprecated DEBUG variable for verbose mode Not checked yet
7 details in Everything
└──▷ BREAKING ON UPGRADE
! The DEBUG environment variable is deprecated in favor of GH_DEBUG for enabling verbose mode
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
$ 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 Not checked yet --failed flag on gh run rerun allows selectively rerunning only failed jobs in a workflow run Not checked yet --job flag on gh run rerun allows specifying a specific job to rerun Not checked yet --profile option added to gh cs cp command Not checked yet Support for setting Dependabot secrets Not checked yet
5 details in Everything
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
$ git checkout v2.5.2
└──▷ USE IT
Use the shorter alias for listing pull requests.
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) Not checked yet Adds --yes flag to gh codespaces create to allow accepting permissions automatically Not checked yet
2 details in Everything
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
$ 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 Not checked yet Includes display name in Codespaces prompts and JSON output Not checked yet
2 details in Everything
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
$ 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 Not checked yet Add release delete-asset to delete an asset from a release Not checked yet Add repo deploy-key commands to manage deploy keys for a repository Not checked yet auth git-credential: add ability to authenticate git operations for gist repositories Not checked yet run list: add branch and actor filters Not checked yet
+2 more
show less
api: do not apply jq filters or render templates for HTTP error responses Not checked yet pr create: fetch pull request template contents via the API Not checked yet
7 details in Everything
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
$ 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 Actions GitHub Actions GitHub'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. Not checked yet Adds --generate-notes flag to gh release create to automatically generate release notes using the new release.create.generate_notes GraphQL field. Not checked yet Allows gh pr merge to edit the commit subject line during a squash, rebase, or merge-commit action. Not checked yet Adds --json flag to gh run list and gh run view to export data in JSON format for programmatic use. Not checked yet
4 details in Everything
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
$ 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. Not checked yet gh secret set supports --no-store flag to print the encoded secret value without saving it. Not checked yet gh auth setup-git command added to configure gh-cli as a git credential helper. Not checked yet gh config list command added to display the current configuration settings. Not checked yet Cyber tooling now supports precompiled extension binaries (e.g. Go) via gh extension create scaffolding and release assets. Not checked yet
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.
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
$ 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. Not checked yet Adds the gh repo delete command. Not checked yet Adds the gh run cancel command. Not checked yet Adds new gpg-key management commands (gh gpg-key). Not checked yet
4 details in Everything
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
$ git checkout v2.1.0
└──▷ TRY IT
Create an archive of the current repository directly from the CLI.
List only draft pull requests in the current repository.
copy
$ gh pr list --draft
Adds repo archive command to create a repository archive Not checked yet Adds support for precompiled extension binaries downloaded via {OS}-{ARCH} suffixes in release assets Not checked yet Adds --draft, --non-draft, and --head filters to pr list Not checked yet Adds --patch flag to pr diff Not checked yet Adds --commit flag to browse to open the permalink for the latest commit Not checked yet
5 details in Everything
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
$ 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 Not checked yet Adds GH_FORCE_TTY environment variable to force terminal-style output when redirected Not checked yet Adds config set browser option and GH_BROWSER environment variable for browser configuration Not checked yet Adds repo sync command to synchronize a local branch with its upstream state Not checked yet Adds tablerow/tablerender template functions for rendering data as tables Not checked yet
+4 more
show less
Adds pr checkout --branch flag to control the branch name during checkout Not checked yet Adds release create --discussion-category flag for release discussion setup Not checked yet Adds repo list --topic filter option Not checked yet Display label colors in issue list output Not checked yet
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
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
$ git checkout v1.14.0
Adds pr merge --admin flag to allow admins to force-merge a pull request Not checked yet Improves shell completion for --json flag with multiple comma-separated fields Not checked yet Adds completion for repo create --gitignore flag Not checked yet Adds completion for repo create --license flag Not checked yet
4 details in Everything
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
$ 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 Not checked yet issue/pr view: outputs label names in their own color Not checked yet
2 details in Everything
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
$ 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 Not checked yet gh browse <file>:<line> to open specific code lines in a browser Not checked yet New templates selection when creating repositories with gh repo create for .gitignore and LICENSE files Not checked yet Config key http_unix_socket added to .config/gh/config.yml to route all gh traffic over a local Unix socket Not checked yet
4 details in Everything
gh now supports GitHub Actions GitHub Actions GitHub'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, XDG XDG A 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
$ 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 Not checked yet Adopts XDG Base Directory specification for configuration storage paths Not checked yet Changes default config directory on Windows from ~/.config/gh/ to %AppData% Not checked yet Includes PR or issue number alongside the title in issue/pr view output Not checked yet
4 details in Everything
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
$ 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. Not checked yet Adds --json flag support to gh repo list/view, gh release view, and gh issue/pr view for structured data output. Not checked yet 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. Not checked yet Allows passing the value for gh alias set via standard input (stdin). Not checked yet Adds shell completion for valid --json flag values on supported commands. Not checked yet
+1 more
show less
Updates gh api placeholder syntax to {owner} and {repo} to align with GitHub API documentation. Not checked yet
6 details in Everything
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
$ 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 Actions GitHub Actions GitHub'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. Not checked yet
1 detail in Everything
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
$ 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 Not checked yet issue transfer subcommand added to reassign ownership of an issue or pull request Not checked yet pr list --author filter option added to filter pull requests by author Not checked yet pr view now displays diffstat information alongside the PR details Not checked yet --body-file flag accepted wherever --body is supported across issue and PR commands Not checked yet
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.
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
$ git checkout v1.7.0
└──▷ USE IT
List all repositories for the current user via the new repo list command.
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 Not checked yet Adds --jq option to gh api to filter JSON output using jq syntax without requiring the external jq utility Not checked yet Adds --template option to gh api to render output using Go templates Not checked yet Adds --cache option to gh api to cache API responses on disk for a specified time Not checked yet Adds --preview option to gh api to opt into GitHub API preview headers Not checked yet
+4 more
show less
Adds support for passing body from file or standard input to issue/pr create Not checked yet Adds --base flag to pr edit command to change the base branch of a PR Not checked yet Allows pr edit and gist view commands to be run without arguments to use interactive prompts Not checked yet Adds -a <file> flag to gist edit to add files to a gist Not checked yet
9 details in Everything
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
$ 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 Not checked yet gh ssh-key list and gh ssh-key add subcommands for managing SSH keys Not checked yet gh issue delete subcommand to permanently delete an issue Not checked yet --auto flag on gh pr merge to enable auto-merge once requirements are met Not checked yet SSH key generation and upload during the gh auth login flow Not checked yet
+9 more
show less
@me syntax support in gh issue create for self-assignment Not checked yet --force and --detach flags on gh pr checkout Not checked yet Git flag support in repo fork subcommand Not checked yet Commit body editing capability in pr merge subcommand Not checked yet Unpushed commit alerting in pr merge subcommand Not checked yet --files flag on gist view to list filenames Not checked yet Environment variable support for specifying the configuration path Not checked yet Branch up-to-date status display in gh pr status output Not checked yet Progress indicator during new pull request creation Not checked yet
14 details in Everything
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
$ 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. Not checked yet Adds gh pr comment command to post comments on pull requests. Not checked yet Adds gh gist clone command to clone gists. Not checked yet pr view now displays top-level review comments inline with regular comments. Not checked yet repo fork adds support for specifying the fork remote name. Not checked yet
5 details in Everything
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
$ 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. Not checked yet Adds a --comments flag to gh issue view and gh pr view to render the full comment thread output. Not checked yet Enables automatic git credential helper configuration during gh auth login flow, removing the need for separate git authentication setup. Not checked yet
3 details in Everything
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
$ 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 Not checked yet issue create now supports --recover option to resume from saved input after a failed interactive invocation Not checked yet Adds support for GH_TOKEN environment variable for authentication Not checked yet Adds support for GH_ENTERPRISE_TOKEN environment variable for authentication Not checked yet
4 details in Everything
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
$ 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 Not checked yet Adds --scopes flag to auth login for explicit authorization scope selection Not checked yet Adds --show-token flag to auth status to display the current auth token in plaintext Not checked yet Adds GH_NO_UPDATE_NOTIFIER environment variable to disable update check prompts Not checked yet
4 details in Everything
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
$ 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 Not checked yet Disables terminal paging when GH_PAGER is set to cat Not checked yet Adds --branch option to repo view to specify a branch for viewing Not checked yet
3 details in Everything
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
$ git checkout v1.0.0
Adds gh release commands for managing GitHub Releases Not checked yet Adds gh pr checks command to check pull request statuses Not checked yet Adds gh gist list, gh gist view, and gh gist edit commands for Gist management Not checked yet Adds --head <branch> flag to gh pr create to explicitly set the head branch Not checked yet Adds gh auth login --web flag for web-based authentication flow Not checked yet
+3 more
show less
Adds prompt disabled value to gh config set prompt config setting Not checked yet Adds gh help environment topic listing all supported environment variables Not checked yet Adds support for PAGER environment variable and pager config option for terminal paging Not checked yet
8 details in Everything
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
$ git checkout v0.12.0
Introduces gh auth status, gh auth login, gh auth refresh, and gh auth logout commands for authentication management Not checked yet Adds support for GitHub Enterprise Server using GH_HOST environment variable to set the default hostname Not checked yet Implements OAuth Device Authorization flow for github.com to enable browserless authentication Not checked yet Enables creating repositories from templates via gh repo create <reponame> --template <owner>/<templaterepo> Not checked yet Enables paging gh pr diff output by respecting the PAGER environment variable Not checked yet
+6 more
show less
Adds --recurse-submodules flag to gh pr checkout command Not checked yet Adds --delete-branch flag to gh pr close command Not checked yet Allows omitting the owner in gh repo view <reponame> instead of requiring <owner>/<reponame> Not checked yet Includes issue/pr number and URL in machine-readable output for gh issue/pr view Not checked yet Adds :branch placeholder support in gh api command Not checked yet Supports GraphQL operationName field filtering in gh api command Not checked yet
11 details in Everything
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
$ git checkout v0.11.1
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
$ 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.
gh api --silent flag added to suppress HTTP response printing Not checked yet --milestone and --mention filters added to gh issue list Not checked yet --web flag added to gh issue/pr list commands Not checked yet Support for shell aliases introduced in the configuration system Not checked yet
4 details in Everything
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
$ 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 Not checked yet Supports pagination for both REST endpoints (using Link headers) and GraphQL queries (using cursor-based pagination) Not checked yet
2 details in Everything
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
$ git checkout v0.10.0
└──▷ TRY IT
Query the GitHub REST API REST API A 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 APIs REST APIs A 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. Not checked yet Adds gh alias command with $1, $2 positional placeholders Not checked yet Respects GITHUB_TOKEN environment variable for authentication Not checked yet Splits configuration into config.yml and hosts.yml files Not checked yet
4 details in Everything
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
$ 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 Not checked yet Adds the gh pr review subcommand with support for the --approve flag and -b body text for automated reviews Not checked yet Adds the gh pr merge subcommand to merge pull requests Not checked yet Adds the gh pr ready subcommand to mark draft pull requests as ready for review Not checked yet
4 details in Everything
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
$ 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 Not checked yet pr close <number> subcommand added to close a pull request Not checked yet pr reopen <number> subcommand added to reopen a pull request Not checked yet pr view now displays Reviewers Not checked yet
4 details in Everything
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
$ 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 Not checked yet Support for the NO_COLOR environment variable to disable colored output Not checked yet
2 details in Everything
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
$ 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 Not checked yet Enables viewing a repository directly in the terminal via gh repo view Not checked yet
2 details in Everything
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
$ 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 Not checked yet Adds PowerShell as a supported shell for tab-completion via gh completion --shell=PowerShell Not checked yet Enables autofilling the title and body of a new pull request with information from git commit messages when using gh pr create Not checked yet
3 details in Everything
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
$ 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 Not checked yet Adds repo create command Not checked yet Adds repo fork command Not checked yet Adds repo view command Not checked yet
4 details in Everything
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
$ git checkout v0.5.6
Provides official linux builds for the arm64 architecture Not checked yet
1 detail in Everything
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
$ git checkout v0.5.5
Enables creating pull requests across different repositories via cross repo pr create Not checked yet
1 detail in Everything
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
$ git checkout v0.5.3
Configures gh for scoop package manager installation Not checked yet Automatically sets up fish completion when installing via Homebrew Not checked yet
2 details in Everything
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
$ git checkout v0.5.0
issue/pr create now offers to finalize editing in the web UI #231 Not checked yet pr create now supports contributing from forks #238 Not checked yet
2 details in Everything
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
$ 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