Gitagger

Gitagger makes tag creation for git projects ridiculously simple and easy!

Just Install it and run gitagger and it will integrate with your existing tag format or initialize one for you.

Full documentation here!

Features

➙ Cross Platform

Gitagger is available on Windows, MacOS and Linux!

➙ Hooks

You can make gitagger run basic hooks via the .gitagger.yml file! you can check out this projects own config and usage of hooks here!

➙ Integrations

Gitagger has native integrations for GitHub Actions, Docker and Jenkins!

Installation

➙ Install with Go

Requires Go 1.26 or newer:

go install github.com/CHE3MZ/gitagger/cmd/gitagger@latest

➙ Prebuilt binaries

You can also grab a ready-made binary from the releases page (Linux, macOS, Windows).

➙ GitHub Actions

- uses: CHE3MZ/gitagger@v1

Tip

Full default template here!

➙ Docker

docker pull ghcr.io/che3mz/gitagger:latest

➙ Compile from source

Requires Go 1.26 or newer:

git clone https://github.com/CHE3MZ/gitagger.git
cd gitagger
go build -o gitagger ./cmd/gitagger

Building the Container Image:

docker build -t gitagger .
docker run --rm -v "$PWD:/repo" -w /repo gitagger [args]

Usage

gitagger                 # next patch tag, pushed if it can be
gitagger minor           # v1.2.3 -> v1.3.0
gitagger major --pre rc  # v1.2.3 -> v2.0.0-rc
gitagger --dry-run       # peek first, change nothing
gitagger --help          # everything else

Want the same settings every time? Run gitagger init once, tweak .gitagger.yml, then forget about flags. running gitagger without any arguments will use your new config file.

Full docs are coming later — for now, gitagger help <command> tells you what each command does.

Development

Contributing

If you'd like to contribute to the project you can check out the contribution guide here!

TODO

The TODO tasks for this project are defined in the TODO.md file here!

State

Gitagger is still pretty early in development and not super polished, but it'll get better with time.

License

Gitagger is Licensed under the Apache 2.0 License.