ApplicationBuilderHelpers 4.1.145

This package has a SemVer 2.0.0 package version: 4.1.145+build.20261001103733.6353458.
dotnet add package ApplicationBuilderHelpers --version 4.1.145
                    
NuGet\Install-Package ApplicationBuilderHelpers -Version 4.1.145
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="ApplicationBuilderHelpers" Version="4.1.145" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="ApplicationBuilderHelpers" Version="4.1.145" />
                    
Directory.Packages.props
<PackageReference Include="ApplicationBuilderHelpers" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add ApplicationBuilderHelpers --version 4.1.145
                    
#r "nuget: ApplicationBuilderHelpers, 4.1.145"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package ApplicationBuilderHelpers@4.1.145
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=ApplicationBuilderHelpers&version=4.1.145
                    
Install as a Cake Addin
#tool nuget:?package=ApplicationBuilderHelpers&version=4.1.145
                    
Install as a Cake Tool

ApplicationBuilderHelpers

Build command-line apps in .NET with plain classes. Mark a class as a command, add options and arguments as properties, then run it.

  • Targets: net6.0 through net10.0 · AOT-ready on net8.0+ · Trimmable
  • Packages: Microsoft.Extensions.Hosting, Microsoft.Extensions.DependencyInjection.Abstractions, AbsolutePathHelpers

Features

  • Commands with automatic parsing. You write a class. The library reads the arguments.
  • Services in your command. Ask for a service. The library provides it.
  • Shared setup modules. Group common services once. Reuse them in every app.
  • App settings that reuse another key with @ref: — see Configuration.
  • Command markers: [Command], [CommandOption], [CommandArgument].
  • Subcommands like deploy prod. Nest as deep as you need.
  • Styled --help with 6 color themes and adjustable width.
  • Console and web hosts. Use the default for CLIs. Plug in your own for servers.

Installation

dotnet add package ApplicationBuilderHelpers

Quick Start

New here? Follow Getting Started for a full Hello sample. It prints Hello, Alice! and exits 0.

RunAsync returns an exit code: 0 success, 2 bad input, 1 failure, 130 canceled. See Commands.

Core Concepts

Extend Command and override Run. Add options with [CommandOption] and positionals with [CommandArgument]. Put shared setup in Application Dependencies.

Exit codes: 0 means success, 2 means bad input, 1 means failure, 130 means canceled. See API Reference.

How a Run Works

Commands → Shared setup → Host build → Services → Your Run method
  1. You register commands and shared setup modules.
  2. The library builds the host once per run.
  3. The library fills your options, arguments, and services.
  4. Your Run method executes.

Full order lives in Commands.

Documentation

Guide Covers
Getting Started Install, minimal app, first command, run it
Commands Commands, options, arguments, services, completion
Application Dependencies Shared setup modules
Configuration & Themes App name, help width, themes, @ref: settings
Custom Type Parsers Support your own option types
Advanced Topics Subcommands, web hosts, errors, help
API Reference Every public class and method

Secret values stay hidden. Help, errors, and completions never print them.

Contributing

Contributions are welcome! Please submit a Pull Request.

License

MIT — see the LICENSE file.

Product Compatible and additional computed target framework versions.
.NET net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 is compatible.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  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 is compatible.  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 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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
4.1.145 27 10/1/2026
4.1.143 32 9/27/2026
4.1.142 40 9/23/2026
4.1.141 46 9/17/2026
4.1.140 42 9/16/2026
4.1.139 44 9/16/2026
4.1.138 43 9/15/2026
4.1.137 40 9/15/2026
4.1.136 45 9/14/2026
4.1.135 50 9/10/2026
4.1.134 389 9/9/2026
4.1.133 43 9/9/2026
4.1.132 49 9/9/2026
4.1.131 98 9/7/2026
4.1.130 60 9/4/2026
4.1.129 86 8/17/2026
4.1.128 47 8/17/2026
4.1.127 78 8/14/2026
4.1.126 49 8/13/2026
4.1.125 49 8/13/2026
Loading failed

## New Version
* Bump `application_builder_helpers` from `4.1.143` to `4.1.145`. See [changelog](https://github.com/Kiryuumaru/ApplicationBuilderHelpers/compare/application_builder_helpers/4.1.143...application_builder_helpers/4.1.145)

## What's Changed
* fix(cli): group-path unknown/invalid beats version (Fixes #586) by @Kiryuumaru in https://github.com/Kiryuumaru/ApplicationBuilderHelpers/pull/587
* fix(cli): uniform version-wins for InvalidValue (Fixes #585) by @Kiryuumaru in https://github.com/Kiryuumaru/ApplicationBuilderHelpers/pull/588
* fix(cli): single-dash-long full-token error and valued-last cluster rule (Fixes #592) by @Kiryuumaru in https://github.com/Kiryuumaru/ApplicationBuilderHelpers/pull/609
* fix(cli): help-first routes valid trailing subcommand to target help by @Kiryuumaru in https://github.com/Kiryuumaru/ApplicationBuilderHelpers/pull/612
* fix(cli): symmetric --help/--version reserved-value rejection (Fixes #594) by @Kiryuumaru in https://github.com/Kiryuumaru/ApplicationBuilderHelpers/pull/611
* fix(cli): strict duplicate/missing-value for repeated valued options (Fixes #593) by @Kiryuumaru in https://github.com/Kiryuumaru/ApplicationBuilderHelpers/pull/613
* docs: slim comments, rewrite guides, split ADR collisions by @Kiryuumaru in https://github.com/Kiryuumaru/ApplicationBuilderHelpers/pull/616
* chore(deps): rebase-only dependabot auto-merge by @Kiryuumaru in https://github.com/Kiryuumaru/ApplicationBuilderHelpers/pull/617
* feat(cli): add -? and /? help aliases (all OS) by @Kiryuumaru in https://github.com/Kiryuumaru/ApplicationBuilderHelpers/pull/619
* cli: expose bool --no-* negation in help + reject bare --no-valued (Fixes #597) by @Kiryuumaru in https://github.com/Kiryuumaru/ApplicationBuilderHelpers/pull/621
* Bump AbsolutePathHelpers from 0.3.146 to 0.3.148 by @dependabot[bot] in https://github.com/Kiryuumaru/ApplicationBuilderHelpers/pull/622
* Bump NukeBuildHelpers from 9.0.41 to 9.0.47 by @dependabot[bot] in https://github.com/Kiryuumaru/ApplicationBuilderHelpers/pull/623

**Full Changelog**: https://github.com/Kiryuumaru/ApplicationBuilderHelpers/compare/build.20260927052237.9a33c35...build.20261001103733.6353458