install

Additional install commands

macOS

Homebrewverified · 100%

brew install ghr

local Homebrew formula metadata

Linux

Nixverified · 92%

nix profile install nixpkgs#ghr

nixpkgs package indexes · pkgs/by-name/gh/ghr/package.nix · source: api.github.com

Windows

Windows Package Managerverified · 92%

winget install --id cataggar.ghr -e

Windows Package Manager source index · cataggar.ghr · source: cdn.winget.microsoft.com

overview

Package summary

Upload multiple artifacts to GitHub Release in parallel

Project links

Commands and aliases

ghr

history

Project history and usage

ghr is a release-engineering CLI for creating GitHub Releases and uploading release artifacts in parallel.

Project history

The ghr repository was created in July 2014, with an initial v0.1.0 release published days later. Its README presents a Go-oriented release workflow: build artifacts, tag a release, and use `ghr TAG PATH` to create a GitHub Release and upload the files.

The tool developed around the practical needs of release automation: reading repository information from `.git/config`, accepting `GITHUB_TOKEN`, supporting GitHub Enterprise through `GITHUB_API`, replacing or recreating assets, marking draft or prerelease releases, and later exposing a GitHub Action wrapper for workflow files.

Adoption history

ghr became useful in the era when projects began publishing multi-platform binaries as GitHub Release assets. The README's demo centers on cross-compiled Go binaries, and the documented Action support shows how the same tool moved into CI-based release pipelines.

How it is used

Practitioners use ghr after a build job has produced a directory of archives, checksums, installers, or other assets. A typical run supplies a tag and path, with optional title, body, commitish, draft, prerelease, replace, delete, generated notes, and parallel upload settings.

Why package nerds care

Package nerds care about ghr because it is release plumbing: it turns build output into a GitHub Release page with assets, which downstream package managers and install scripts often consume.

Timeline

2014: GitHub repository created.
2014: v0.1.0 initial release published.
2021: GitHub automatic release notes support arrived in GitHub, and ghr later documented a `-generatenotes` flag.
2020s: README documents a reusable GitHub Action interface.

Related projects

The README compares ghr with aktau/github-release and connects it to GitHub Releases, GitHub Enterprise, GitHub Actions, Go cross-compilation, checksums, and CI build artifacts.

Sources

security posture

Risk level: blue

broad file, network, media, or database tool signal.

Risk classifier

blue risk · medium confidence · tool

Why

broad file, network, media, or database tool signal

Signals

text:upload

Install behavior

No Homebrew post-install hook is recorded in formula metadata.
Homebrew bottle metadata is available for 6 platform targets.
Build metadata lists 1 build dependencies.

Recommended review

Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.

executables

Installed executables

Command	Kind	Exposure	Note
`ghr`	cli	global executable

freshness

Version and freshness

These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.

page generated2026-07-08

manager version0.18.3

manager updated2026-04-15

local dataok

upstreamcurrent

latest detectedv0.18.3

https://github.com/tcnksm/ghr

okNo freshness warnings were generated.

install metadata

Package metadata

Package key	brew:ghr
Version	0.18.3
Package manager	Homebrew
Package manager page	https://formulae.brew.sh/formula/ghr
Homepage	https://github.com/tcnksm/ghr
Repository	https://github.com/tcnksm/ghr
Upstream docs	https://github.com/tcnksm/ghr#readme
License	MIT
Source archive	https://github.com/tcnksm/ghr/archive/refs/tags/v0.18.3.tar.gz
Last updated	2026-04-15T17:45:20Z
Pulse	updated
Build dependencies	go
Bottle	available (on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux)
Homebrew post-install	not defined
Service	none declared

registry facts

Source database details

Source Database	Homebrew formula API
Tap	homebrew/core
Full Name	ghr
Version Scheme	0
Revision	0
Head Version	HEAD
Bottle Stable Root URL	https://ghcr.io/v2/homebrew/core
Deprecated	no
Disabled	no
Keg Only	no
URL Keys	head stable

source database matches

Other package-manager records

Matches are pulled from external package-manager indexes and kept separate from local Automic Vault package links.

Nix95%

ghr

nix profile install nixpkgs#ghr

normalized package name match
Matched by: Ghr

nixpkgs package indexes · api.github.com · nixpkgs package indexes: pkgs/by-name/gh/ghr/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

winget95%

cataggar.ghr

winget install --id cataggar.ghr -e

normalized package name match
Matched by: Ghr

Windows Package Manager source index · cdn.winget.microsoft.com · Windows Package Manager source index: cataggar.ghr from https://cdn.winget.microsoft.com/cache/source.msix

package graph

Links come from deterministic package relationships, av.db category and tag curation, ecosystem matches, and package hub membership.

source trail

Generated from repository data

This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.

Combined YAML source

View the package source record on GitHub.

combined/ghr.yml

Used sources

Geiger risk classifier
Nucleus package database
av.db category and tag curation
cross-ecosystem install command graph
curated package history
external package-manager database matches
package relationship graph
package version freshness
package-page enrichment

Install ghr with Homebrew, Nix, winget