hello terminal fans, it's me @vilmibm .

We are pleased to bring you a new release of the GitHub CLI on this Confusion 46, 3189 YOLD.

We've got features. we've got bugfixes. This release has a real zest for life; can you feel it?

First though, a sad note. @mislav has moved on from GitHub. He was instrumental to this project and without him I don't think it would have ever happened. BIG THANKS MUCH LOVE to this wonderful person!

Happily, we have a new core team member who is, truly, a delight. Please welcome @williammartin , whom you'll see a lot more on issues and pull requests moving forward.

Now, let's talk BUSINESS.

gh ruleset

Repository Rulesets are in beta on git hub dot com and they are now also in beta on git hub sea ell eye. You can list, view, and check branches against rulesets set at the repository or organization level. Major shoutouts to @vaindil for this big contribution. My favorite command in here is gh rs check <branch> which will tell you what rules would apply to a hypothetical branch name. To learn more, run gh help ruleset.

gh cache

gh cache is a new top level command in our suite of support for Actions. It lets you list and delete caches saved in Actions. It's neat and I like it. Thanks, @joshkraft ! To learn more, run gh help cache.

Other new stuff

• Add option to remove file from gist by @kousikmitra in #7560
• Add remove/reset to auth refresh by @n1lesh in #7597
• Small tweaks to auth refresh remove-scopes and reset-scopes flags by @samcoe in #7631
• make gh pr create behavior like gh repo fork by @leavesster in #7330
• chore: add title to iteration and milestone fields by @kamaz in #7621
• AutoFetch new branch created with gh issue develop by @shion1305 in #7589
• feat: add statuscheck description to pr checks output by @jgrumboe in #7451
• Always show created gist privacy status. by @seanbright in #7645
• [Codespaces] Support random --server-port=0 and printing connection details by @josebalius in #7655
• gh release edit: support --verify-tag like gh release create by @rajhawaldar in #7646
• Feature: Add fill-first flag to pr create command by @kousikmitra in #7398
• Return error on no-browser option if repo don't exists by @kousikmitra in #7314

Bugfixes

• Early exit repo sync if merge-upstream requires workflow scope by @williammartin in #7612
• Don't deduplicate checks that stem from different events by @samcoe in #7618
• gh run cancel needs input validation by @rajhawaldar in #7647
• Ensure gist edit request body matches desired schema by @williammartin in #7635
• fix(api): do not interpret "branch" placeholder when GH_REPO is set by @alex-petrov-vt in #7626
• fix pr create crash on interactive milestone selection by @vilmibm in #7666
• Fix issue develop command by @samcoe in #7656

Docs & Dev

• docs: example of setting multiple vars using stdin by @iloveitaly in #7683
• Remove old code paths and improve code comments for repo sync by @samcoe in #7610
• Update httpretty to released version by @josebalius in #7654
• build(deps): bump github.com/henvic/httpretty from 0.1.1 to 0.1.2 by @dependabot in #7657
• build(deps): bump google.golang.org/grpc from 1.49.0 to 1.53.0 by @dependabot in #7665
• Use SmartBaseRepoFunc for api command by @whi-tw in #7594
• Clean up style nits and simplify some logic by @samcoe in #7687
• add gh cache to Actions explainer by @vilmibm in #7689

New Contributors

• @leavesster made their first contribution in #7330
• @kamaz made their first contribution in #7621
• @shion1305 made their first contribution in #7589
• @jgrumboe made their first contribution in #7451
• @whi-tw made their first contribution in #7594
• @seanbright made their first contribution in #7645
• @iloveitaly made their first contribution in #7683

Full Changelog: v2.31.0...v2.32.0

What's New

• New suite of project commands for interacting with and manipulating projects. Huge shoutout 🥳 for the time and effort put into this work by @mntlty in #7375 #7578
• New search code command by @joshkraft in #7376
• New cs view command by @dmgardiner25 in #7496 #7539

What's Changed

• api: output a single JSON array in REST pagination mode by @mislav in #7190
• api: support array params in GET queries by @mislav in #7513
• api: force method to uppercase by @ffalor in #7514
• alias: Allow aliases to recognize extended commands by @srz-zumix in #7523
• alias import: Fix --clobber flag by @samcoe in #7569
• run rerun: Improve docs around --job flag by @williammartin in #7527
• run view: Support viewing logs for jobs with composite actions by @williammartin in #7526
• gist edit: Add selector option to gist edit command by @kousikmitra in #7537
• repo clone: Set upstream remote to track all branches after initial fetch by @samcoe in #7542
• extension: Speed up listing extensions by lazy-loading extension information when needed by @mislav in #7493
• auth: Add timeouts to keyring operations by @samcoe in #7580
• auth status: write to stdout on success by @rajhawaldar in #7540
• completion: Fix bash completions for extensions and aliases by @mislav in #7525
• issue/pr view: alphabetically sort labels for gh pr/issue view by @ffalor in #7587
• Fix error handling for extension and shell alias commands by @samcoe in #7567
• Fix pkg imported more than once by @testwill in #7591
• Refactor a nested if statement by @yanskun in #7596
• Fix a typo by @lerocknrolla in #7557
• Fix flaky test by @samcoe in #7515
• Credential rotations, renames and decouplings from Mislav by @williammartin in #7544
• build(deps): bump github.com/cli/go-gh/v2 from 2.0.0 to 2.0.1 by @dependabot in #7546
• build(deps): bump github.com/AlecAivazis/survey/v2 from 2.3.6 to 2.3.7 by @dependabot in #7576

New Contributors

• @srz-zumix made their first contribution in #7523
• @lerocknrolla made their first contribution in #7557
• @testwill made their first contribution in #7591
• @rajhawaldar made their first contribution in #7540

Full Changelog: v2.30.0...v2.31.0

What's New

• Support for nested aliases by @samcoe in #7457
• repo set-default --view can now be called without a repo argument by @Jackenmen in #7441

What's Changed

• Color control and sensible defaults in modern terminals by @rick-kilgore in #7354
• Fix windows crash by bumping wincred by @mislav in #7459
• Update browser package to avoid Windows crash by @mislav in #7474
• release upload sanitizes asset filenames prior to uploading by @jtpetty in #7477
• pr status uses lighter API in supported environments by @williammartin in #7462
• All commands start up time improvements by @mislav in #7487
• More commands use latin matching filter by @benjlevesque in #7492
• pr create respects GH_REPO env variable by @ffalor in #7445
• Do not fall back to legacy template if template selector returns nil by @samcoe in #7444

All the Details

• Fix release guard for deployment workflow by @mislav in #7424
• Introduce helpTopics type and reduce duplication across commands by @williammartin in #7414
• Allow gh repo set-default --view without repo argument by @Jackenmen in #7441
• make prompt default values visible and also the color controllable in… by @rick-kilgore in #7354
• Mention setting GH_ENTERPRISE_TOKEN when GH_HOST is set by @goldstar611 in #7449
• respect GH_REPO env variable in pr create by @ffalor in #7445
• Do not fall back to legacy template if template selector returns nil by @samcoe in #7444
• Remove old, unused detector fields by @williammartin in #7458
• Fix windows crash by bumping wincred by @mislav in #7459
• Get some additional confidence around PullRequest ChecksStatus by @williammartin in #7454
• build(deps): bump github.com/stretchr/testify from 1.8.1 to 1.8.2 by @dependabot in #7460
• build(deps): bump github.com/stretchr/testify from 1.8.2 to 1.8.3 by @dependabot in #7469
• Update triage.md with severity descriptions by @williammartin in #7473
• Clarify docs regarding what is listed when running gh workflow list by @torgeir in #7475
• build(deps): bump github.com/mattn/go-isatty from 0.0.18 to 0.0.19 by @dependabot in #7476
• Update browser package to avoid Windows crash by @mislav in #7474
• Updated to sanitize asset filename prior to uploading. Fixes #7024 by @jtpetty in #7477
• replace prompts in gh run commands by @vilmibm in #7302
• Allow nested aliases by @samcoe in #7457
• Use new GQL fields that support CheckRun and StatusContext counts by state by @williammartin in #7462
• Speed up gh start up time by @mislav in #7487
• Do not generate docs for aliases by @samcoe in #7497
• fix: apply latin matching filter to more fields by @benjlevesque in #7492
• build(deps): bump github.com/stretchr/testify from 1.8.3 to 1.8.4 by @dependabot in #7510

New Contributors

• @williammartin made their first contribution in #7414
• @rick-kilgore made their first contribution in #7354
• @goldstar611 made their first contribution in #7449
• @torgeir made their first contribution in #7475

Full Changelog: v2.29.0...v2.30.0

What's New

• Add alias import command by @kevhlee in #7118
• codespace: Add capability to filter by --repo-owner by @kousikmitra in #7347
• pr status: display auto-merge information by @mjpieters in #7386
• pr view: display auto-merge information by @mjpieters in #7385
• pr: add autoMergeRequest field to JSON output by @mjpieters in #7384

What's Changed

• repo create: fix empty default description for local repository by @vwkd in #7383
• release download: show progress bar by @joshkraft in #7380
• codespace delete: print confirmation message by @kousikmitra in #7353
• Fix shellcheck errors in generate.sh by @cmbrose in #7392
• New deployment workflow for releases by @mislav in #7324
• make install: fix for macOS by @Xerkus in #7369

New Contributors

• @vwkd made their first contribution in #7383

Full Changelog: v2.28.0...v2.29.0

What's New

• macOS binaries are now signed and notarized

  • ⚠️ macOS archives attached to our releases are no longer .tar.gz, but .zip instead. This is because .tar.gz archives cannot be notarized.
  • The checksums.txt file attached to every release now includes the checksum of the Windows MSI installer too.

• macOS and Windows binaries are now compiled from their respective platforms and have cgo enabled. This might help resolve respecting system proxy settings and avoid related networking issues.

• issue edit: edit multiple issues at the same time by @heaths in #7259

• Add gh org list by @joshkraft in #7257

• ssh-key: add ability to manage signing keys by @kousikmitra in #7270

• search: enable owner flag to take multiple values by @kousikmitra in #7305

• codespace: add --web flag for list & create commands by @doaortu in #7288

• Our Debian & RPM packages now ship with shell completion scripts by @Xerkus in #7293

• run list: add --event and --created filters by @cawfeecake in #7363 #7352

• repo: add visibility JSON field by @yeikel in #7337

What's Changed

• Fix typo in cs stop command: Stoppping -> Stopping by @FalseDev in #7318
• Update go-gh to v2 by @samcoe in #7299
• auth login: normalize host name by @tuananhlai in #6999
• build(deps): bump github.com/cenkalti/backoff/v4 from 4.2.0 to 4.2.1 by @dependabot in #7323
• Clarify how SSH keys are selected for gh codespace ssh by @jkeech in #7325
• Initialize deployment.yml workflow file by @mislav in #7328
• Fix gh cs ports requiring sudo for privileged port numbers by @cmbrose in #7326
• Correct some typos by @goggle in #7342
• Diacritics substitution in prompt by @benjlevesque in #7205
• gh: move CODEOWNERS inside the .github/ dir by @SauravMaheshkar in #7366
• Pretty-print gh api output when using --jq by @mjpieters in #7236

New Contributors

• @joshkraft made their first contribution in #7257
• @kousikmitra made their first contribution in #7270
• @doaortu made their first contribution in #7288
• @FalseDev made their first contribution in #7318
• @tuananhlai made their first contribution in #6999
• @goggle made their first contribution in #7342
• @Xerkus made their first contribution in #7293
• @cawfeecake made their first contribution in #7363
• @yeikel made their first contribution in #7337
• @SauravMaheshkar made their first contribution in #7366
• @mjpieters made their first contribution in #7236

Full Changelog: v2.27.0...v2.28.0

v2.27.0

This is primarily an out of band bugfix release for codespaces users, but does include a new command gh run delete.

New Features

• add command gh run delete by @phillippbertram in #7254
• add R as shorthand of --repo for search subcommands by @kkocha in #7274

Bugfixes

• Fix codespaces invoker immediately closing by @cmbrose in #7284

New Contributors

• @phillippbertram made their first contribution in #7254

Full Changelog: v2.26.1...v2.27.0-pre0

What's Changed

• extend secure storage default to auth refresh by @vilmibm in #7278

Full Changelog: v2.26.0...v2.26.1

gh 2.26.0

Important: credentials now stored securely by default

When running gh auth login, your credentials will now be stored in your operating system's credential storage instead of directly on disk. In other words, --secure-storage is now default behavior. We've added a new flag, --insecure-storage, to opt into the old insecure behavior in case you need to debug an issue with credential storage.

As before, to take advantage of credential storage, please re-run gh auth login.

For more context, you can read the v2.24.0 release notes

Ref: secure storage by default by @vilmibm in #7276

Other new features

• Allow filtering workflow runs by status by @alex-petrov-vt in #7249
• Gist rename by @wingkwong in #7212
• Add a --fail-fast option to pr checks --watch by @benjlevesque in #7203
• Add --template for issue and PR by @guerinoni in #7185
• gh run view --attempt by @wingkwong in #7232
• utocomplete branch flags by @bchadwic in #6031

Bugfixes

• Make number arg, commit arg, and flags mutually exclusive by @kkocha in #7268
• Check SSH key existence before uploading by @vaindil in #7246
• Throw error for non-existing org / repo with non-zero status in repo list by @wingkwong in #7240

Docs and development changes

• Bump github.com/mattn/go-isatty from 0.0.17 to 0.0.18 by @dependabot in #7217
• Properly handle closing files that have been writen to by @samcoe in #7199
• Added apt update command to linux install docs. by @srgk26 in #7186
• Revise GH_CONFIG_DIR content in help_topic.go by @wingkwong in #7230
• Refine the Makefile file so that it can do the basic work by @cubxxw in #7228
• Clearer message with actionable hint for repo sync by @macmacbr in #7110
• Fix typo in README.md by @SonicGDX in #7244
• Retry fetching repo from template by @heaths in #7080
• Repo list: add test for invalid owner error by @mislav in #7241
• Improve Amazon Linux install instructions by @mislav in #7252
• Add commit SHA arg to gh browse help by @kkocha in #7267
• Additional help doc and example for auth setup-git by @kkocha in #7243

New Contributors

• @wingkwong made their first contribution in #7212
• @srgk26 made their first contribution in #7186
• @cubxxw made their first contribution in #7228
• @macmacbr made their first contribution in #7110
• @SonicGDX made their first contribution in #7244
• @vaindil made their first contribution in #7246
• @kkocha made their first contribution in #7267

Full Changelog: v2.25.1...v2.26.0-pre0

What's Changed

• variable: fix listing and deleting per-environment variables by @rsteube in #7207

Full Changelog: v2.25.0...v2.25.1

What's New

• New suit of commands for working with Repository and Organization variables
  • variable set by @atirikt in #6928
  • variable list by @atirikt in #6995
  • variable delete by @atirikt in #6929
• ext install: Introduce new --force flag by @heaths in #7173

What's Changed

• browse: Improve documentation and consistency of the --commit flag by @alex-petrov-vt in #7105
• repo sync: Ensure git fetch is always authenticated by @samcoe in #7139
• repo delete: Don't delete repos that have transfered ownership by @samcoe in #7106
• auth: Skip searching keyring when checking for environment tokens by @benjlevesque in #7169
• auth refresh: Improve documentation of --scopes flag behavior by @alex-petrov-vt in #7132
• pr status: Hide "current branch" when using --repo flag by @jtpetty in #7180
• repo archive: Change to use Prompter package by @Ruminateer in #7083
• search: Fix multiword keyword quoting by @samcoe in #7170
• Replace deprecated command with environment file by @jongwooo in #7195
• New prompt testing utility by @vilmibm in #7116
• Use transform.Transformer interface for ascii sanitization by @samcoe in #7117
• Only replace control sequences by @samcoe in #7168
• Tech debt cleanup for variable and secret commands by @samcoe in #7151
• Bump actions/setup-go from 3 to 4 by @dependabot in #7177

New Contributors

• @atirikt made their first contribution in #6928
• @jtpetty made their first contribution in #7180
• @jongwooo made their first contribution in #7195

Full Changelog: v2.24.3...v2.25.0