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. - When multiple - --messageare passed, their values are concatenated with a
blank line in-between.
 - When neither - --messagenor- --filewere 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 - --messagefor the formatting rules.
 
- -e, --edit
- Open the release title and description in a text editor before submitting.
This can be used in combination with - --messageor- --file.
 
- -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 - %b: body - %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 - %n: newline - %%: a literal % 
- --color[=WHEN]
- Enable colored output even if stdout is not a terminal. WHEN can be one
of "always" (default for - --color), "never", or "auto" (default).
 
- TAG
- The git tag name for this release.