Release process
Building, signing, notarizing, and publishing is handled by
.github/workflows/release.yml,
triggered by a tag push.
Steps
Sign in at https://developer.apple.com/account and accept any pending agreements (e.g. an updated Apple Developer Program License Agreement). Otherwise notarization fails.
Update version in the following files and commit on
master:CHANGELOG.mdmain.goinstallinstall.ps1man/man1/fzf.1man/man1/fzf-tmux.1
Verify file consistency, sign the tag, and push the tag.
make tag VERSION=0.74.5make tagrunsprereleasefirst (checks that the version appears in CHANGELOG.md, both man pages, install, and install.ps1) and only signs + pushes the tag if the checks pass.Only the tag is pushed;
masteron origin still points to the old version, so/master/installkeeps resolving against existing binaries during the publish window.The workflow fires on the tag push and pauses on the
releaseenvironment gate. Approve it in the Actions tab to release.- goreleaser creates a draft release
- The
msijob builds the Windows MSIs, uploads them, and publishes the release - The
wingetjob submits the release to winget
After the
msijob publishes the GitHub release, fast-forwardmaster:git push origin master
If the msi job fails
The release stays a draft. Do not push master until it is published.
Fix the problem and re-run the failed jobs, or
Publish without MSIs and submit to winget by hand:
gh release edit v0.74.5 --draft=false gh workflow run winget.yml -f release-tag=v0.74.5
Testing the workflow
To exercise the workflow without firing a real release:
- Actions tab -> Release -> Run workflow.
- Pick a branch and enter the version currently on that branch (the version-consistency check requires the input to match the files in the checked-out tree).
- Approve the
releaseenvironment gate when prompted. - Goreleaser runs with
--snapshot --skip=publish. Signing and notarization run; only the GitHub release upload is skipped. - The
msijob builds the MSIs and uploads them as thewindows-msiartifact of the run. The release upload and thewingetjob are skipped.
Use this to validate the workflow YAML, version-extraction logic, the macOS runner setup, and the signing/notarization credentials.