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)