PromtyBuild Beautiful CLI Tools

A powerful and flexible command-line parser and command executor framework for .NET

Get Started

View on GitHub

🎯

Type-Safe Argument Binding

Automatically bind command-line arguments to strongly-typed classes with full IntelliSense support.

🚩

Long & Short Flags

Support for both --verbose and -v style flags with automatic help text generation.

📝

Automatic Help Generation

Beautiful, table-formatted help text generated automatically from attributes.

⚡

Process Command Execution

Easily wrap external CLI tools and forward arguments seamlessly.

🎨

Attribute-Based Configuration

Use simple attributes to configure commands and arguments - minimal boilerplate.

✅

Built-in Validation

Automatic validation for required arguments with helpful error messages.

🔄

Flags Enums

Group related boolean flags into a single [Flags] enum for cleaner code.

🎁

Flexible Architecture

Extend Command or ProcessCommand base classes to suit your needs.

Quick Example

csharp

using Promty;

[Description("greet", "Greets a person by name")]
public class GreetCommand : Command<GreetCommand.Args>
{
    public class Args
    {
        [Description("name", "The name of the person to greet")]
        public string Name { get; set; } = string.Empty;

        [FlagAlias("uppercase", 'u')]
        [Description("Print the greeting in uppercase")]
        public bool Uppercase { get; set; }
    }

    public override Task<int> ExecuteAsync(Args args)
    {
        var greeting = $"Hello, {args.Name}!";
        if (args.Uppercase) greeting = greeting.ToUpper();
        Console.WriteLine(greeting);
        return Task.FromResult(0);
    }
}

bash

# Run your command
dotnet run -- greet Alice --uppercase
# Output: HELLO, ALICE!

Installation

.NET CLIPackageReference