HUB-RELEASE(1)

NAME
hub-release - Manage GitHub releases.

SYNOPSIS
hub release [--include-drafts] [--exclude-prereleases] [-L LIMIT]
hub release show 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, --asset 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
    Use the first line of MESSAGE as release title, and the rest as release description.

-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

TAG The git tag name for this release.

SEE ALSO
hub(1), git-tag(1)