ReleaseGen 0.2.0
See the version list below for details.
dotnet tool install --global ReleaseGen --version 0.2.0
dotnet new tool-manifest
dotnet tool install --local ReleaseGen --version 0.2.0
#tool dotnet:?package=ReleaseGen&version=0.2.0
nuke :add-package ReleaseGen --version 0.2.0
ReleaseGen
ReleaseGen is an opinionated .NET CLI for building, packaging, and publishing .NET projects. One strict releasegen.json manifest drives every stage of a release: build, test, package, and publish.
Install
dotnet tool install -g ReleaseGen
Requires the .NET 10 SDK. The tool command is releasegen. Running bare releasegen prints command help; no stage executes without an explicit verb.
Quickstart
# 1. Write a minimal releasegen.json in the current directory
releasegen init
# 2. Edit releasegen.json: name your targets (projects and their artifact kinds),
# declare runtimeIdentifiers, and optionally add test and publish sections
# 3. Run the pipeline the manifest names, in manifest order
releasegen run
Notes:
initis a one-shot command and takes no part in the chained run. It refuses to overwrite an existing manifest unless you pass--overwrite;--preset <name>seeds the manifest'sbuild.presetkey.runis the chained run: it executes the stages the manifest names - build always, test when a test section is declared, package and publish when targets declare package kinds - in manifest order, aborting at the first failed stage and noting each skipped stage. The test outcome is carried to publish, so tests never run twice.- Each stage is also its own command -
releasegen build,releasegen test,releasegen package,releasegen publish- and all of them share the same manifest, discovered by walking up from the current directory.
Build output stays local under a release/ directory; the only network destination is the publish stage's NuGet source. Publishing is gated on your tests: a manifest declaring a test section blocks publish when that stage fails.
Commands
| Command | Purpose |
|---|---|
init |
Write a minimal manifest (one-shot) |
build |
Publish release binaries per target and runtime identifier |
test |
Run the projects the manifest's test section names |
package |
Pack the package kinds each target declares |
publish |
Push packages to NuGet sources (test-gated) |
run |
Chained run of the stages above, in manifest order |
Every command accepts the global --quiet flag; every stage command and run also accept
--dry-run and --verbose (which contradict --quiet); exit code is 0 on success and 1
on any failure. See the command reference for flags and behavior.
Documentation
- Changelog
- Command reference
- Manifest schema
- Build presets
- Single-file rules
- Trusted publishing in CI
- Stage handoff contract
- Glossary
What ReleaseGen isn't
- A changelog or release notes generator/formatter.
- A test coverage checker.
- An artifact uploader: ReleaseGen writes release binaries and archives to a local
release/directory and performs no upload of them. - A token broker: ReleaseGen performs no OIDC token acquisition; see the trusted publishing page for the CI-side procedure.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. 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. |
This package has no dependencies.
| Version | Downloads | Last Updated |
|---|---|---|
| 0.4.0 | 94 | 11/9/2026 |
| 0.3.0 | 102 | 11/4/2026 |
| 0.2.0 | 113 | 11/1/2026 |
| 0.1.0-alpha.0 | 75 | 10/25/2026 |
Breaking release: the build preset is now `aot` (was `aot-plus-trimming`), the target key is now `archiveFormats` (was `archive`), and an absent archive key defaults to zip plus tar.gz on Unix-based rids. New: `--dry-run`, `--verbose`, tar.xz archives, and a detection-seeded, `--interactive` init. See CHANGELOG.md.