GitVelocity CLI — distribution

Public distribution repository for the GitVelocity CLI (gv).

The source lives in the private repo headlinevc/gitvelocity-cli. This repo holds only the release binaries — published automatically by GoReleaser on each tagged release. There is no source code here.

Prebuilt binaries are provided for darwin/arm64, darwin/amd64, linux/amd64, linux/arm64, and windows/amd64.

macOS & Linux — Homebrew (recommended)

Homebrew works on both macOS and Linux (Linuxbrew):

brew install headlinevc/tap/gitvelocity
brew upgrade gitvelocity

# Verify
gv version

Linux — direct download

No Homebrew? Download the tarball for your architecture, extract the gv binary, and put it on your PATH:

# Pick your arch: Linux_x86_64 (amd64) or Linux_arm64
curl -L -o gv.tar.gz \
  https://github.com/headlinevc/gitvelocity-cli-dist/releases/latest/download/gitvelocity_0.1.3_Linux_x86_64.tar.gz

tar -xzf gv.tar.gz gv
sudo install gv /usr/local/bin/gv

# Verify
gv version

Replace 0.1.3 with the version you want, or browse the Releases tab. latest/download/... always resolves to the newest release.

Windows

There is no Homebrew or Scoop package yet, so install the .zip manually (only amd64 is built for Windows):

PowerShell

$v = "0.1.3"
$dest = "$env:USERPROFILE\bin"
New-Item -ItemType Directory -Force -Path $dest | Out-Null
Invoke-WebRequest `
  -Uri "https://github.com/headlinevc/gitvelocity-cli-dist/releases/latest/download/gitvelocity_${v}_Windows_x86_64.zip" `
  -OutFile gv.zip
Expand-Archive gv.zip -DestinationPath $dest -Force

# Add $dest to your PATH (one-time), then verify:
gv version

Or manually:

1. Download gitvelocity_0.1.3_Windows_x86_64.zip from the Releases tab.
2. Extract gv.exe.
3. Move it to a folder on your PATH (e.g. %USERPROFILE%\bin), or add the folder to your PATH.
4. Run gv version.

Verifying checksums

Every release includes checksums.txt (SHA-256). To verify a download:

# Linux / macOS
sha256sum -c checksums.txt --ignore-missing

# Windows (PowerShell) — compare against the matching line in checksums.txt
Get-FileHash .\gitvelocity_0.1.3_Windows_x86_64.zip -Algorithm SHA256

Asset naming

Release assets follow gitvelocity_<version>_<OS>_<arch>.{tar.gz,zip}:

Platform	Asset
macOS (Apple Silicon)	gitvelocity_<version>_Darwin_arm64.tar.gz
macOS (Intel)	gitvelocity_<version>_Darwin_x86_64.tar.gz
Linux (amd64)	gitvelocity_<version>_Linux_x86_64.tar.gz
Linux (arm64)	gitvelocity_<version>_Linux_arm64.tar.gz
Windows (amd64)	gitvelocity_<version>_Windows_x86_64.zip

Note: go install is not supported — the source module is private. Use Homebrew or a direct binary download.