air-release

README

air-release

A tiny local release helper: computes the next semantic version from conventional commits since the latest git tag, and generates a changelog section.

No configuration, no CI required, no dependencies beyond git.

Install

go install github.com/air-verse/air-release@latest

Usage

Run from the root of the repository you want to release:

air-release           # preview the next version and changelog
air-release -write    # also prepend the new section to CHANGELOG.md
air-release -tag      # also create the annotated git tag (implies -write)

Then push the tag to trigger your release pipeline (e.g. goreleaser):

git push origin vX.Y.Z

How the version is decided

Commits since the latest vX.Y.Z tag are parsed as conventional commits:

Commit	Bump
feat!: ... or BREAKING CHANGE in body	major
feat: ...	minor
anything else (fix:, docs:, non-conventional, ...)	patch

The changelog groups commits into Breaking Changes / Features / Bug Fixes / Performance / Others. Non-conventional commits are kept under Others rather than dropped, so review the output before tagging.

License

GPL-3.0

Documentation

Overview

Command air-release computes the next semantic version from conventional commits since the latest tag and generates a changelog section.

Run it from the root of the repository you want to release:

air-release           # preview next version and changelog
air-release -write    # also prepend the section to CHANGELOG.md
air-release -tag      # also create the git tag (implies -write)