Skip to content

Releasing

This project is configured for GoReleaser.

Prerequisites

  • Create a GitHub personal access token with repo scope and export as GITHUB_TOKEN in your shell.
  • Ensure a clean working tree and a tagged commit.
  • Install goreleaser: https://goreleaser.com/install/

Snapshot builds

Generate local artifacts without publishing:

  • goreleaser release --snapshot --clean

Artifacts appear under dist/.

Full release

  1. Tag a new version:
  2. git tag -a v0.1.0 -m "v0.1.0"
  3. git push origin v0.1.0
  4. Run GoReleaser:
  5. GITHUB_TOKEN=... goreleaser release --clean

This will: - Build binaries for multiple OS/ARCH - Produce checksums and archives - Create/update a GitHub Release with changelog - Optionally publish a Homebrew formula (if repository exists and permissions allow)

Notes

  • The Go toolchain version is 1.25 (see go.mod and go.work).