gh-select

Releases

Read release notes and download the build that fits your machine, with checksums verified.

View as Markdown

Open the releases

Press enter on a repository and choose Releases…. You see the last 100 releases with the notes of the highlighted one next to them.

The list of releases with notes

n reads the notes full screen, o opens the release page and y copies its link.

Download an asset

Press enter on a release to see its downloads. The one that fits your OS and CPU is already highlighted and marked ◆ this machine.

The downloads of a release, with this machine marked

KeyAction
enterdownload
xdownload and unpack
spacemark several
amark all
vpreview a text file
ycopy the download link

Files go into the current directory, or into --download-dir or GH_SELECT_DOWNLOAD_DIR.

Safe by default

  • If the release has a checksum file, each download is checked against it. A mismatch deletes the file.
  • Existing files are never overwritten.
  • A download is renamed to its real name only when it is complete.
  • Unpacking supports .tar.gz, .tgz, .tar.bz2 and .zip. Entries that would escape the folder are refused, and links are skipped.

How it picks your build

gh-select reads your OS and CPU and looks for them in the file names, in common spellings such as macos, darwin, x86_64, amd64 and aarch64. Portable archives rank above plain binaries, and plain binaries above installers.

Private repositories you can access work too.

Edit this page on GitHub

Last updated on

On this page