Skip to content
Projects

idc101/git-mkver has 57 GitHub stars and 14 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-15 21:20 UTC. Last push 2026-11-08.

How these counts are measured

What you can do

  • Last tagged commit
  • Conventional Commits
  • Next version conforms to Semantic Versioning scheme
  • Patch the next version into source files using a configurable find and replace system

Measured star growth

in 24h
0
in 7 days
Update delayed
in 15 days
Update delayed
in 1 month
Update delayed

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

About

Automatic Semantic Versioning for git based software development

Developer Tools

README.md

Original

git-mkver

Automatic Semantic Versioning for git based software development.

For more information head to the project site.

Features

  • Determine next version based on:
  • Next version conforms to Semantic Versioning scheme
  • Patch the next version into source files using a configurable find and replace system
  • Tag the current commit with the next version number

Works out of the box with trunk based development, GitFlow and GithubFlow. Alternatively all of this can be configured based on the branch name so release/main branches get different version numbers to develop or feature branches.

Installation

Install with brew, scoop or simply download the binary for your os from the releases page and copy somewhere on your path.

Usage

Start by using Conventional Commits to indicate whether the commits contain major, minor or patch level changes.

$ git commit -m "feat: added a new feature (this will increment the minor version)"

Then call git mkver next and it will tell you the next version of the software should be if you publish now.

$ git mkver next
v0.4.0

Tagging

If you would like to publish a version, git-mkver can tag the current commit.

$ git mkver tag

This will apply an annotated tag from the next command to the current commit.

Patching versions in files

If you would like to patch version numbers in files prior to building and tagging then you can use the patch command. The files to be patched and the replacements are defined in the mkver.conf config file. A large number of standard patches come pre-defined.

$ git mkver patch