NAME

       hub-release - Manage GitHub releases.

SYNOPSIS

       hub release [--include-drafts] [--exclude-prereleases] [-L LIMIT] [-f FORMAT]
       hub release show [-f FORMAT] TAG
       hub release create [-dpoc] [-a FILE] [-m MESSAGE|-F FILE] [-t TARGET] TAG
       hub release edit [options] TAG
       hub release download TAG
       hub release delete TAG

COMMANDS

       With no arguments, shows a list of existing releases.

       With  --include-drafts, include draft releases in the listing. With --exclude-prereleases,
       exclude non-stable releases from the listing.

       show   Show GitHub release notes for TAG.

              With --show-downloads, include the "Downloads" section.

       create Create a GitHub release for the specified TAG name. If git tag TAG  doesn`t  exist,
              it will be created at TARGET (default: current branch).

       edit   Edit  the  GitHub  release  for the specified TAG name. Accepts the same options as
              create command. Publish a draft with --draft=false.

              When MESSAGE or FILE are not specified, a text editor will open pre-populated  with
              current  release  title and body. To re-use existing title and body unchanged, pass
              -m "".

       download
              Download the assets attached to release for the specified TAG.

       delete Delete the release and associated assets for the specified TAG.

OPTIONS

       -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.

              If multiple MESSAGE options are given, their values are  concatenated  as  separate
              paragraphs.

       -F, --file=FILE
              Read the release title and description from FILE.

       -e, --edit
              Further edit the contents of FILE in a text editor before submitting.

       -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 doesn`t
              already exist (default: main branch).

       -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 %

       TAG    The git tag name for this release.

SEE ALSO

       hub(1), git-tag(1)