GhVersionManager 2.0.2

dotnet tool install --global GhVersionManager --version 2.0.2
                    
This package contains a .NET tool you can call from the shell/command line.
dotnet new tool-manifest
                    
if you are setting up this repo
dotnet tool install --local GhVersionManager --version 2.0.2
                    
This package contains a .NET tool you can call from the shell/command line.
#tool dotnet:?package=GhVersionManager&version=2.0.2
                    
nuke :add-package GhVersionManager --version 2.0.2
                    

GhVersionManager

GhVersionManager is a .NET 8 command-line tool for reading and updating version panels in Grasshopper .gh and .ghx files. Version 2 keeps the command forms and exit codes used by existing pipelines.

Install

dotnet tool install --global GhVersionManager

Use

# Read the first panel nicknamed "version"
ghversionmanager path\to\definition.gh

# Set it, or create it when missing
ghversionmanager path\to\definition.gh -v 1.2.3

Windows and Linux are supported. On Ubuntu/Debian runners, install image support first:

sudo apt-get update
sudo apt-get install -y libgdiplus

For verification, cleanup, conversion, size inspection, and object-editing commands, install the GhTools package. Complete GitHub Actions examples are available in the project repository.

Exit codes

0 success, 1 processing error, 2 missing version or usage error, 3 write failure.

License

MIT License. See LICENSE.txt for details.

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

This package has no dependencies.

Version Downloads Last Updated
2.0.2 0 9/21/2026
2.0.1 52 9/20/2026
1.0.4-beta 551 7/3/2025
1.0.3-beta 202 7/3/2025
1.0.2-beta 180 7/3/2025
1.0.1-beta 192 7/3/2025
1.0.0-beta 177 7/1/2025

Linux archive support. Linux runners require libgdiplus.