With no arguments, shows a list of existing releases.
- -d, --include-drafts
List drafts together with published releases.
- -p, --exclude-prereleases
Exclude prereleases from the list.
- -L, --limit
Display only the first LIMIT releases.
- -d, --draft
Create a draft release.
- -p, --prerelease
Create a pre-release.
- -a, --attach FILE
Attach a file as an asset for this release.
If FILE is in the "filename#text" format, the text after the "#"
character is taken as asset label.
- -m, --message MESSAGE
The text up to the first blank line in MESSAGE is treated as the release
title, and the rest is used as release description in Markdown format.
--message are passed, their values are concatenated with a
blank line in-between.
--file were supplied to
release create, a
text editor will open to author the title and description in.
- -F, --file FILE
Read the release title and description from FILE. Pass "-" to read from
standard input instead. See
--message for the formatting rules.
- -e, --edit
Open the release title and description in a text editor before submitting.
This can be used in combination with
- -o, --browse
Open the new release in a web browser.
- -c, --copy
Put the URL of the new release to clipboard instead of printing it.
- -t, --commitish TARGET
A commit SHA or branch name to attach the release to, only used if TAG
does not already exist (default: main branch).
- -i, --include PATTERN
Filter the files in the release to those that match the glob PATTERN.
- -f, --format FORMAT
Pretty print releases using FORMAT (default: "%T%n"). See the "PRETTY
FORMATS" section of git-log(1) for some additional details on how
placeholders are used in format. The available placeholders for issues are:
%U: the URL of this release
%uT: tarball URL
%uZ: zipball URL
%uA: asset upload URL
%S: state (i.e. "draft", "pre-release")
%sC: set color to yellow or red, depending on state
%t: release name
%T: release tag
%as: the list of assets attached to this release
%cD: created date-only (no time of day)
%cr: created date, relative
%ct: created date, UNIX timestamp
%cI: created date, ISO 8601 format
%pD: published date-only (no time of day)
%pr: published date, relative
%pt: published date, UNIX timestamp
%pI: published date, ISO 8601 format
%%: a literal %
Enable colored output even if stdout is not a terminal. WHEN can be one
of "always" (default for
--color), "never", or "auto" (default).
The git tag name for this release.