LinuxCommandLibrary

gh-release

Manage GitHub releases and distribution assets

TLDR

List releases

$ gh release list
copy
Create a release
$ gh release create [tag]
copy
Create with title and notes
$ gh release create [tag] -t "[title]" -n "[notes]"
copy
Create with assets
$ gh release create [tag] [file1] [file2]
copy
Create draft release
$ gh release create [tag] --draft
copy
Download release assets
$ gh release download [tag]
copy
View a release
$ gh release view [tag]
copy
Delete a release
$ gh release delete [tag]
copy

SYNOPSIS

gh release command [options]

DESCRIPTION

gh release manages GitHub releases for versioned software distribution. Releases package git tags with release notes and downloadable binary assets, providing an official distribution mechanism.
The command supports creating releases from existing tags or creating tags automatically. Release notes can be written manually, loaded from files, or auto-generated from commit messages and merged pull requests using the --generate-notes flag. Assets like compiled binaries, packages, and archives can be uploaded during creation or added later.

PARAMETERS

-t, --title title

Release title.
-n, --notes notes
Release notes.
-F, --notes-file file
Read notes from file.
--draft
Create as draft.
--prerelease
Mark as prerelease.
--generate-notes
Auto-generate notes.

SUBCOMMANDS

list

List releases.
create
Create a release.
view
View a release.
download
Download assets.
delete
Delete a release.
upload
Upload assets.
edit
Edit a release.

SEE ALSO

gh(1), gh-repo(1)

> TERMINAL_GEAR

Curated for the Linux community

Copied to clipboard

> TERMINAL_GEAR

Curated for the Linux community