Cxset 1.0.0

Cxset

A .NET CLI tool for managing versions and changelogs across multiple projects in a repository.

Installation

From NuGet

dotnet tool install --global Cxset

From Source

cd Cxset
dotnet pack
dotnet tool install --global --add-source ./bin/Release Cxset

Uninstall

dotnet tool uninstall --global Cxset

Usage

Adding a Changeset

cxset add

This will:

1. List all eligible .csproj files (those with a <Version> element)
2. Prompt you to select which projects are affected (comma-separated numbers or a for all)
3. Ask for the change type: patch, minor, or major
4. Ask for a description of the changes (enter an empty line to finish)

A changeset file is created in .changes/ with the following format:

---
changeset: minor
timestamp: 2026-02-04T15:00:00Z
projects:
  - src/MyProject/MyProject.csproj
  - src/MyLibrary/MyLibrary.csproj
---
Added new feature X
Fixed bug Y

Publishing Changesets

cxset publish

This will:

1. Read all pending changesets from .changes/
2. Determine the version bump based on the largest change type (major > minor > patch)
3. Bump the version (stored in .changes/.version, starting from 0.0.0)
4. Update the <Version> element in each affected .csproj file
5. Append entries to CHANGELOG.md in each affected project's directory
6. Delete the processed changeset files

Version Bumping

When multiple changesets exist, the largest change type wins.

Project Structure

For a project to be eligible for version management, it must have a <Version> element in its .csproj file:

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>net8.0</TargetFramework>
    <Version>1.0.0</Version>
  </PropertyGroup>
</Project>

Files

Example Workflow

# Make some changes to ProjectA and ProjectB
git add .

# Record what changed
cxset add
# Select: 1, 2 (ProjectA and ProjectB)
# Type: 2 (minor)
# Description: Added user authentication

# Make more changes to just ProjectA
git add .

cxset add
# Select: 1 (ProjectA only)
# Type: 1 (patch)
# Description: Fixed login bug

# When ready to release
cxset publish
# Both projects get version bump (minor wins)
# ProjectA CHANGELOG has both entries
# ProjectB CHANGELOG has only the first entry

Requirements

• .NET 10.0 SDK or later

License

MIT