GitHub - kazhuravlev/git-tools: Useful set of tools which helps to manage git tags (original) (raw)

Git Tools

Go Reference License Build Status Go Report Card Mentioned in Awesome Go

A CLI tool for managing git repositories with semantic versioning tags. Simplifies version bumping, tag validation, and git hook management.

Quick example:

git commit -am "changes" && gt t i min && git push --follow-tags

Commits changes, increments minor version (e.g., v1.2.3 → v1.3.0), ready to push

Key features:

Installation

Golang

go install github.com/kazhuravlev/git-tools/cmd/gt@latest

Homebrew

brew install kazhuravlev/git-tools/git-tools

Docker (zsh) (will work only in current directory)

echo 'alias gt="docker run -it --rm -v pwd:/workdir kazhuravlev/gt:latest"' >> ~/.zshrc

Usage

All commands work with the current directory by default. Use --repo=/path/to/repo to specify a different repository.

Commands

Tag Management:

gt tag last # Show last semver tag (alias: gt t l) gt tag last -f tag # Show only tag name (useful for CI/CD)

gt tag increment major # Bump major version: v1.2.3 → v2.0.0 (alias: gt t i maj) gt tag increment minor # Bump minor version: v1.2.3 → v1.3.0 (alias: gt t i min) gt tag increment patch # Bump patch version: v1.2.3 → v1.2.4 (alias: gt t i pat)

Other Commands:

gt lint # Validate tag format consistency gt authors # List commit authors with statistics (alias: gt a) gt hooks install all # Install git hooks (alias: gt h i a) gt hooks list # List available hooks (alias: gt h l)

Options

Force tag creation:

Create a new tag even if current commit already has a semver tag

gt t i min --ignore-exists-tag

Custom repository path:

gt --repo=/path/to/repo tag last

Examples

Typical workflow: commit, bump version, push

git commit -am "Add new feature" gt t i min # Creates v1.3.0 tag git push --follow-tags

CI/CD: Get version for build artifact

VERSION=$(gt tag last -f tag) echo "Building version: $VERSION"

Check tag consistency before release

gt lint