# GitTools/GitVersion

From git log to SemVer in no time

Repository: https://github.com/GitTools/GitVersion
Canonical: https://ross.abutalabs.com/products/gitversion
Homepage: https://gitversion.net/docs/
Language: C#
License: MIT
License Family: permissive
Topics: c-sharp, git, semver, versioning, dotnet
Last push: 2026-08-25T15:08:10+00:00

## Health v2 (maintenance only)
Score: 97/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 99, release rhythm 92, longevity 100
- inputs: {"age_days": 4754, "days_push": 8, "days_rel": 54, "gap_med": 23, "n_releases_24m": 16}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 3145, forks 660 (observed 2026-08-28T04:07:45.977656+00:00)

## What it is
GitVersion is a tool that calculates a Semantic Version (SemVer) number for a commit by analyzing a repository's Git history and branching strategy. It can be consumed as a CLI, .NET tool, MSBuild task, NuGet library, Docker container, or CI pipeline task to stamp versions on builds and artifacts.

## Use cases
- generate semantic version numbers from git history
- version nuget packages automatically in CI
- calculate semver from gitflow or github flow branches
- patch assemblyinfo.cs with version numbers during build
- integrate versioning into github actions or azure devops pipelines
- stamp build artifacts with version numbers on a build server
- run versioning in docker containers in ci pipelines

## When to choose
- you need automatic SemVer generation driven by git history and branching conventions
- you build .NET projects and want assembly version patching via MSBuild
- you use CI servers like GitHub Actions, Azure DevOps, GitLab CI, or Jenkins and need version variables in the pipeline
- you follow GitFlow or GitHub Flow and want pre-release versions for PRs and release branches

## When to avoid
- your project does not use git or does not follow any recognizable branching strategy
- you need a fully supported stable library API - the NuGet library option is explicitly unsupported and may break between releases
- you use a simple fixed version number scheme unrelated to git history

## Facets
- artifact type: cli-tool
- maturity: stable
- function: build-tool, developer-tools, ci-cd, version-control
- domain: developer-tools, version-control
- platform: cross-platform, cli, dotnet, windows
- tags: semver, versioning, git, dotnet, msbuild, continuous-integration, assembly-versioning, devops, docker, linux, macos

## Member repositories
- GitTools/GitVersion (main) score 97

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:45.977656+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T07:25:58.431880+00:00, confidence not recorded.
  - readme: https://github.com/GitTools/GitVersion (fetched 2026-08-28T04:07:45.977656+00:00, sha 3dfbacadf517)
  - homepage: https://gitversion.net/docs/ (fetched 2026-08-29T09:40:43.102605+00:00, sha c96988970977)
  - site_page: https://gitversion.net/5.12.0/docs (fetched 2026-08-29T09:40:43.105223+00:00, sha 345bf61f20f6)
  - site_page: https://gitversion.net/docs/usage (fetched 2026-08-29T09:40:43.107140+00:00, sha 1e8da2ab167a)
  - site_page: https://gitversion.net/docs/usage/ci (fetched 2026-08-29T09:40:43.108968+00:00, sha 1225cd805539)
  - site_page: https://gitversion.net/docs/usage/cli (fetched 2026-08-29T09:40:43.111495+00:00, sha e5dfd91e55fa)
  - site_page: https://gitversion.net/docs/usage/cli/installation (fetched 2026-08-29T09:40:43.113975+00:00, sha d52b0a3ef3e1)
  - site_page: https://gitversion.net/docs/usage/cli/arguments (fetched 2026-08-29T09:40:43.115992+00:00, sha 319ab712b6fd)
  - site_page: https://gitversion.net/docs/usage/cli/output (fetched 2026-08-29T09:40:43.117743+00:00, sha 5e42593fe3c8)
  - site_page: https://gitversion.net/docs/usage/cli/assembly-patch (fetched 2026-08-29T09:40:43.119330+00:00, sha b5dcb124e4d9)
- Data as of 2026-08-30T08:39:29.467469+00:00.