v8.1.0

8.1.0 (2026-06-17)

Features

• add --tag-prefix option (#224) (380851c)

v8.0.0

8.0.0 (2026-06-17)

Changelog formats supported as of v8.0.0 (thanks to updates in changelog-parser):

• Keep a Changelog
• Conventional Changelog
• Release Please
• Standard Version
• auto-changelog

⚠ BREAKING CHANGES

• the "publish release to github?" confirmation now defaults to yes. Pressing Enter, or any answer that is not n/no, publishes the release; previously only y/yes published and an empty answer declined.
• gh-release no longer requires a CHANGELOG.md.
  • A missing CHANGELOG.md is no longer an error; gh-release tags from the package.json version with an empty body.
  • An empty matching changelog section is no longer an error; it produces an empty-body release instead of failing with missing required options: body.
  • body is no longer a required option: it is removed from OPTIONS.required, and validate() no longer reports it missing.
  • To populate the body without changelog notes, pass --generate-notes (or generate_release_notes: true).
• This package is now ESM-only.
  • ESM: import the named export, import { ghRelease } from 'gh-release'. The default export, import ghRelease from 'gh-release', remains available for backwards compatibility.
  • CommonJS: on Node 22.12+, require('gh-release') works (require(esm) is unflagged there) but returns the module namespace rather than the function, so const ghRelease = require('gh-release') no longer works. Use const { ghRelease } = require('gh-release') or const ghRelease = require('gh-release').default.
  • The minimum supported Node.js version is now 22.12.0.
  • Authentication is now token-only: the interactive ghauth login and its OAuth app are removed, username/password (HTTP basic auth) is removed, and the Release.clientId static is removed. GitHub disabled password authentication for its API in 2020.
• drop support for Node versions <20, update deps, patch sec vulns (#196)
• drop node 14, 16, add 20

Features

• default the publish prompt to yes (#222) (6aaa08e)
• relax changelog and body requirements (#221) (62fa42c)

Bug Fixes

• handle 422 commitish, silence git stderr (#223) (76f47a2)

Miscellaneous Chores

• drop support for Node versions <20, update deps, patch sec vulns (#196) (a4e7d5b)

Build System

• convert to TypeScript and ESM (#219) (928ea5f)

Continuous Integration

• drop node 14, 16, add 20 (6c0e586)

v7.0.2

Maintenance update. Removes dependency rimraf in favor of builtin fs functionality.

Fixes

• fix: rm rimraf, use fs.rm

v7.0.1

Fixes

• fix(pkg): update minimum supported node version to 14

v7.0.0

Breaking

• drop support for Node 12 (EOL)

Misc

• add Node 18 to test matrix
• deps: @octokit/rest@^19.0.5
• deps: gauge@^5.0.0
• remove npm scripts, dev dependencies, and source files related to deprecated doc site

v6.0.4

Changed

• pkg(engines): set min node to 12
  • note: minimum node was already 12 as of v6.x, this just updates requirement in package.json
• deps: gauge@^v4.0.4 (#169)

Misc

• minor (cosmetic) doc updates

v6.0.3

Changed

• deps: rm chalk (#163)
• deps(dev): rm live-server, tap-spec, use serve (#162)

v6.0.2

Note: this repo has moved from https://github.com/hypermodules/gh-release to
https://github.com/ungoldman/gh-release. @ungoldman is the original author and
the same people that have been maintaining gh-release will continue to do so.
The move was made because the hypermodules org is being retired.

Changed

• Repo ownership changed! Updated links. #161
• Update gauge to ^4. #147

v6.0.1

Changed

• Re-read package.json when creating releases. #137
• Update gauge to ^3. #136

v6.0.0

Changed

• BREAKING CHANGE: upgrade to Yargs 17. Node 10 is definitely EOL and not supported now.