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)
air-release -release  # also push the tag and create a GitHub release (implies -tag)

With -tag, push the tag manually to trigger your release pipeline (e.g. goreleaser):

git push origin vX.Y.Z

With -release, the tag is pushed for you and a GitHub release is created via the gh CLI, using the generated changelog section as the release notes. Requires gh to be installed and authenticated (gh auth login).

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)
air-release -release  # also push the tag and create a GitHub release via gh (implies -tag)