NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
NuGet
NuGet, #2245 most downloaded on NuGet
A .NET Core Tool that can install, read and set version information based on git history, using Nerdbank.GitVersioning.
Latest stable
3.10.94
Last release 1 months ago
05 Oct 2026
Release timing varies
gaps range from 8 days to 4 months
Most releases are documented
notes for 49 of the last 60 stable releases
2 versions withdrawn
withdrawn after publishing
127 years old
123 releases · first in 1900
Drag across the ruler to compare, or tap a release to open it.
Add reftable support to the managed Git engine by @AArnott in https://github.com/dotnet/Nerdbank.GitVersioning/pull/1543
Full Changelog: https://github.com/dotnet/Nerdbank.GitVersioning/compare/v3.11.128-beta...v3.11.202-beta
Fix version height parity for filtered paths by @AArnott in https://github.com/dotnet/Nerdbank.GitVersioning/pull/1489
Full Changelog: https://github.com/dotnet/Nerdbank.GitVersioning/compare/v3.11.96-beta...v3.11.128-beta
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Refine git version unavailable strings by @AArnott in https://github.com/dotnet/Nerdbank.GitVersioning/pull/1465
Full Changelog: https://github.com/dotnet/Nerdbank.GitVersioning/compare/v3.11.93-beta...v3.11.96-beta
Emit placeholder Git metadata when Git engine is disabled by @AArnott in https://github.com/dotnet/Nerdbank.GitVersioning/pull/1436
nbgv install observe the default branch name when creating version.json by @AArnott with @Copilot in https://github.com/dotnet/Nerdbank.GitVersioning/pull/1243GetEffectiveGitEngine_NbgvGitEngineOverridesDependabot test by @AArnott in https://github.com/dotnet/Nerdbank.GitVersioning/pull/1405Full Changelog: https://github.com/dotnet/Nerdbank.GitVersioning/compare/v3.11.13-beta...v3.11.93-beta
Adding G# support by @DavidObando in https://github.com/dotnet/Nerdbank.GitVersioning/pull/1403
Full Changelog: https://github.com/dotnet/Nerdbank.GitVersioning/compare/v3.11.1-beta...v3.11.13-beta
Implement nbgv path-filters command for monorepo pathFilters automation by @AArnott in https://github.com/dotnet/Nerdbank.GitVersioning/pull/1397
Full Changelog: https://github.com/dotnet/Nerdbank.GitVersioning/compare/v3.10.85...v3.11.1-beta
Fix version height parity for filtered paths by @AArnott in https://github.com/dotnet/Nerdbank.GitVersioning/pull/1489
Full Changelog: https://github.com/dotnet/Nerdbank.GitVersioning/compare/v3.10.91...v3.10.94
Retry file operations on access denied errors by @AArnott in https://github.com/dotnet/Nerdbank.GitVersioning/pull/1408
Full Changelog: https://github.com/dotnet/Nerdbank.GitVersioning/compare/v3.10.85...v3.10.91
Avoid writing server.json multiple times in a single pack by @AArnott in https://github.com/dotnet/Nerdbank.GitVersioning/pull/1391
Full Changelog: https://github.com/dotnet/Nerdbank.GitVersioning/compare/v3.10.70...v3.10.85
Fix case insensitivity for the managed engine on git worktrees, and implement for libgit2 by @AArnott in https://github.com/dotnet/Nerdbank.GitVersion
Full Changelog: https://github.com/dotnet/Nerdbank.GitVersioning/compare/v3.9.50...v3.10.70
Nothing published for this version
Fix case insensitivity for the managed engine on git worktrees, and implement for libgit2 by @AArnott in https://github.com/dotnet/Nerdbank.GitVersion
Full Changelog: https://github.com/dotnet/Nerdbank.GitVersioning/compare/v3.10.8-alpha...v3.10.44-alpha
Add prerelease property to inheriting version.json files by @Copilot in https://github.com/dotnet/Nerdbank.GitVersioning/pull/1317
Full Changelog: https://github.com/dotnet/Nerdbank.GitVersioning/compare/v3.9.50...v3.10.8-alpha
Add versionHeightOffsetAppliesTo property to version.json by @Copilot in https://github.com/dotnet/Nerdbank.GitVersioning/pull/1279
versionHeightOffsetAppliesTo property to version.json by @Copilot in https://github.com/dotnet/Nerdbank.GitVersioning/pull/1279nbgv prepare-release command to honor inheriting version.json files by @AArnott in https://github.com/dotnet/Nerdbank.GitVersioning/pull/1281Full Changelog: https://github.com/dotnet/Nerdbank.GitVersioning/compare/v3.8.118...v3.9.50
Auto-disable git engine for GitHub Copilot environments by @Copilot in https://github.com/dotnet/Nerdbank.GitVersioning/pull/1291
Full Changelog: https://github.com/dotnet/Nerdbank.GitVersioning/compare/v3.9.32-alpha...v3.9.37-alpha
Automatically disable git engine for Dependabot environments by @Copilot in https://github.com/dotnet/Nerdbank.GitVersioning/pull/1284
Full Changelog: https://github.com/dotnet/Nerdbank.GitVersioning/compare/v3.9.17-alpha...v3.9.32-alpha
Fix nbgv prepare-release command to honor inheriting version.json files by @AArnott in https://github.com/dotnet/Nerdbank.GitVersioning/pull/1281
nbgv prepare-release command to honor inheriting version.json files by @AArnott in https://github.com/dotnet/Nerdbank.GitVersioning/pull/1281Full Changelog: https://github.com/dotnet/Nerdbank.GitVersioning/compare/v3.9.15-alpha...v3.9.17-alpha
Nothing published for this version
Don't try to disable CA2243 warnings in the generated version info files for F# by @Numpsy in https://github.com/dotnet/Nerdbank.GitVersioning/pull/11
nbgv set-version to write to the best version.json file in scope by @AArnott in https://github.com/dotnet/Nerdbank.GitVersioning/pull/1264Full Changelog: https://github.com/dotnet/Nerdbank.GitVersioning/compare/v3.7.115...v3.8.118
Add option to set / skip CloudBuildNumber by @MattKotsenas in https://github.com/dotnet/Nerdbank.GitVersioning/pull/1190
nbgv set-version to write to the best version.json file in scope by @AArnott in https://github.com/dotnet/Nerdbank.GitVersioning/pull/1264Full Changelog: https://github.com/dotnet/Nerdbank.GitVersioning/compare/v3.8.38-alpha...v3.8.106-alpha
Don't try to disable CA2243 warnings in the generated version info files for F# by @Numpsy in https://github.com/dotnet/Nerdbank.GitVersioning/pull/11
Full Changelog: https://github.com/dotnet/Nerdbank.GitVersioning/compare/v3.7.115...v3.8.38-alpha
Nothing published for this version
This list of changes was auto generated.
This list of changes was auto generated.
Fix typo in the Cake extension documentation comment by @kapsiR in https://github.com/dotnet/Nerdbank.GitVersioning/pull/939
ThisAssembly class by @AArnott in https://github.com/dotnet/Nerdbank.GitVersioning/pull/976prepare-release command by @fmacavilca in https://github.com/dotnet/Nerdbank.GitVersioning/pull/996global:: for all references to types in System.* namespaces. by @alexrp in https://github.com/dotnet/Nerdbank.GitVersioning/pull/1012Language special-casing to handle supported programming languages. by @alexrp in https://github.com/dotnet/Nerdbank.GitVersioning/pull/1021NBGV_UseAssemblyVersionInNativeVersion msbuild property by @vitezslav-popovsky-solarwinds in https://github.com/dotnet/Nerdbank.GitVersioning/pull/1125Full Changelog: https://github.com/dotnet/Nerdbank.GitVersioning/compare/v3.6.146...v3.7.112
Switch System.Text.Json to non-vulnerable version by @AArnott in https://github.com/dotnet/Nerdbank.GitVersioning/pull/1074
Full Changelog: https://github.com/dotnet/Nerdbank.GitVersioning/compare/v3.7.70-alpha...v3.7.77-alpha
This list of changes was auto generated.
#1056: Bump BenchmarkDotNetVersion from 0.13.10 to 0.13.12
#1057: Bump Newtonsoft.Json.Schema from 3.0.15 to 3.0.16 <details><summary><b>See More</b></summary>
#1039: Merge latest Library.Template
#1050: Merge v3.6 to main
#1046: Bump typescript from 5.4.3 to 5.4.5 in /src/nerdbank-gitversioning.npm
#265: Add AssemblyInfo.GitCommitId property
#264: Remove g prefix in commit IDs
#255: Fix for issue #149 - Adding F# support for AssemblyInfo generation
#252: Not working in .NET Core docker image
#254: Update Cake.Core dependency to 0.30.0
#1024: Change F# AssemblyInfo generation to always include a do() after the …
#245: Fix attribute name in readme
#241: Switch to Azure Pipelines
#242: Remove typings to fix build break
#243: Capture all nupkg files as artifacts
#240: is it possible to update LibGit2Sharp package version from 0.25.2 to 0.26.0-preview-0054?
#238: Upgrade Typescript + npm cleanup
#236: npm setPackageVersion semver2 support
#235: Add a few properties for easier processing at the command line
#231: Remove names from regex capture groups in version.schema.json
#232: NPM/Yarn-only way of versioning packages
#234: Add cake-contrib user to Cake.GitVersioning NuGet package
#994: Fix build.ps1 script
#992: I have a problem building the solution
#982: Fix WPF incremental build
#175: NB.GV defeats incremental build for .NET SDK style WPF projects
#945: Revert "Drop BuildMetadata from NPM package version"
#938: Downgrade Cake.Core to v2.3.0
#934: Cake.GitVersioning v3.6+ doesn't support Cake v2.x anymore
#936: Fix BitBucket handling of publicReleaseRefSpec
This list of changes was auto generated.</details>
AssemblyVersionInfo: Use global:: for all references to types in System.* namespaces. by @alexrp in https://github.com/dotnet/Nerdbank.GitVersioning/p
global:: for all references to types in System.* namespaces. by @alexrp in https://github.com/dotnet/Nerdbank.GitVersioning/pull/1012Language special-casing to handle supported programming languages. by @alexrp in https://github.com/dotnet/Nerdbank.GitVersioning/pull/1021Full Changelog: https://github.com/dotnet/Nerdbank.GitVersioning/compare/v3.7.48-alpha...v3.7.62-alpha
Added option to include package version in ThisAssembly class. PR #976
ThisAssembly class. PR #976prepare-release command. PR #996Ensure we use System.Drawing.Common 4.7.2 by @flcdrg in https://github.com/dotnet/Nerdbank.GitVersioning/pull/1090
Full Changelog: https://github.com/dotnet/Nerdbank.GitVersioning/compare/v3.6.143...v3.6.146
Update NuGet.PackageManagement to v6.3.4 by @flcdrg in https://github.com/dotnet/Nerdbank.GitVersioning/pull/1082
Full Changelog: https://github.com/dotnet/Nerdbank.GitVersioning/compare/v3.6.141...v3.6.143
Switch System.Text.Json to non-vulnerable version by @AArnott in https://github.com/dotnet/Nerdbank.GitVersioning/pull/1074
Full Changelog: https://github.com/dotnet/Nerdbank.GitVersioning/compare/v3.6.139...v3.6.141
Fix WPF incremental build by @AArnott in https://github.com/dotnet/Nerdbank.GitVersioning/pull/982
Full Changelog: https://github.com/dotnet/Nerdbank.GitVersioning/compare/v3.6.133...v3.6.139
Revert "Drop BuildMetadata from NPM package version" by @AArnott in https://github.com/dotnet/Nerdbank.GitVersioning/pull/945
Full Changelog: https://github.com/dotnet/Nerdbank.GitVersioning/compare/v3.6.132...v3.6.133
Fix BitBucket handling of publicReleaseRefSpec by @AArnott in https://github.com/dotnet/Nerdbank.GitVersioning/pull/936
Full Changelog: https://github.com/dotnet/Nerdbank.GitVersioning/compare/v3.6.128...v3.6.132
Bump Cake.Core from 2.3.0 to 3.0.0 by @Dependabot in https://github.com/dotnet/Nerdbank.GitVersioning/pull/867
$(Language) by @AArnott in https://github.com/dotnet/Nerdbank.GitVersioning/pull/900Full Changelog: https://github.com/dotnet/Nerdbank.GitVersioning/compare/v3.6.79-alpha...v3.6.128
Fix Cake.Tool install failure by @AArnott in https://github.com/dotnet/Nerdbank.GitVersioning/pull/861
NBGV_SetMauiVersionProperties to suppress new behavior by @AArnott in https://github.com/dotnet/Nerdbank.GitVersioning/pull/860tagName option to customize generated tag name by @ronaldbarendse in https://github.com/dotnet/Nerdbank.GitVersioning/pull/875Full Changelog: https://github.com/dotnet/Nerdbank.GitVersioning/compare/v3.6.65-alpha...v3.6.79-alpha
Revert some of the path casing change by @AArnott in https://github.com/dotnet/Nerdbank.GitVersioning/pull/763
Full Changelog: https://github.com/dotnet/Nerdbank.GitVersioning/compare/v3.5.113...v3.6.65-alpha
Add GetTargetPath target for SqlServer projects by @AArnott in https://github.com/dotnet/Nerdbank.GitVersioning/pull/821
Full Changelog: https://github.com/dotnet/Nerdbank.GitVersioning/compare/v3.5.113...v3.5.119
DeltaStreamReader should interpret instruction with size 0 as 0x10000 by @marcin-krystianc in https://github.com/dotnet/Nerdbank.GitVersioning/pull/81
Full Changelog: https://github.com/dotnet/Nerdbank.GitVersioning/compare/v3.5.112...v3.5.113
Fix break in tests from VS 17.3 by @AArnott in https://github.com/dotnet/Nerdbank.GitVersioning/pull/804
Stream.Seek implementations to reliably shift position as required by @AArnott in https://github.com/dotnet/Nerdbank.GitVersioning/pull/816Full Changelog: https://github.com/dotnet/Nerdbank.GitVersioning/compare/v3.5.109...v3.5.112
This list of changes was auto generated.
This list of changes was auto generated.
This list of changes was auto generated.
This list of changes was auto generated.
This list of changes was auto generated.
dotnet watch fails due to missing _CollectWatchItems targetThis list of changes was auto generated.
This list of changes was auto generated.
As part of adding support for MSBuild's static graph feature, we changed the way Nerdbank.GitVersioning invokes itself for shared version calculations
ProjectReference items in a way we haven't tested with, then you might see a build error such as #751 ("PrivateP2PCaching.proj : error MSB4057: The target "x" does not exist in the project."). Please report such errors as new issues for each unique target that cannot be found, and apply the workaround prescribed in #751 to unblock yourself.## Changes: * #729: Merge v3.4 to master
This list of changes was auto generated.
GenerateAssemblyVersionInfo msbuild target to GenerateAssemblyNBGVVersionInfo#712: Allow a way for consumers to supply their own targets to the private P2P target
#696: Build with the .NET 6.0 SDK, update packages <details><summary><b>See More</b></summary>
#667: Add property that can disable the private MSBuild task invocation
#666: fix: extend error message in case there are uncommited changes, in order to get the files which are causing the issue
#624: Informational version supports four components
#653: Add Cake alias for the "cloud" command
#598: Add SpaceAutomation cloud build support
dotnet publish on an app that uses NB.GVdotnet publish is broken in 3.5.34/37-alpha with MSB4057-graph -isolate switchesThis list of changes was auto generated.</details>
## Changes: ### Breaking changes: * #701: Rename GenerateAssemblyVersionInfo msbuild target to GenerateAssemblyNBGVVersionInfo ### Fixes: * #698: Conf
GenerateAssemblyVersionInfo msbuild target to GenerateAssemblyNBGVVersionInfonbgv get-commits to require version matching## Changes: ### Fixes: * #687: Fix packing a project that references NB.GV * #679: Add empty Clean target
This list of changes was auto generated.
dotnet publish is broken in 3.5.34/37-alpha with MSB4057This list of changes was auto generated.
This list of changes was auto generated.
nbgv dependenciesis null pattern and analyzerThis list of changes was auto generated.
This list of changes was auto generated.
-graph -isolate switches#657: Retarget the nbgv tool against netcoreapp3.1 now that netcoreapp2.1 is out of service
#650: Document considerations for building inside a container <details><summary><b>See More</b></summary>
#649: Drop .NET Core 2.1 SDK support
#638: Always generate commit ID component of version as big endian
#611: Fix spelling error
#608: Add cake-addin tag to Cake.GitVersioning NuGet package
#599: Abort prepare-release command when version on current branch is not incremented
This list of changes was auto generated.</details>
## Changes: ### Breaking changes: ### Fixes: * #682: Fixes nbgv get-commits to require version matching * #693: Fixed typo in ParentEnumerator.MoveNex
nbgv get-commits to require version matchingThis list of changes was auto generated.
cloudBuild.buildNumber to null, but this violates the JSON schemacloudBuild.buildNumber: null being written for nbgv prepare-releaseThis list of changes was auto generated.
This list of changes was auto generated.
nbgv dependenciesis null pattern and analyzerThis list of changes was auto generated.
This list of changes was auto generated.
This list of changes was auto generated.
This list of changes was auto generated.
This list of changes was auto generated.
This list of changes was auto generated.
This list of changes was auto generated.
This list of changes was auto generated.
This list of changes was auto generated.
This list of changes was auto generated.
One column per quarter.