This repository contains the code for the System.CommandLine libraries and the dotnet-suggest global tool. For more information, see our wiki.

Packages

Package	Version	Description
`System.CommandLine`		Command line parser, model binding, invocation, shell completions
`System.CommandLine.DragonFruit`		Build command-line apps by convention with a strongly-typed `Main` method
`System.CommandLine.Rendering`		Structured terminal output rendering and ANSI support
`System.CommandLine.Hosting`		support for using System.CommandLine with Microsoft.Extensions.Hosting
`dotnet-suggest`		A command-line tool to provide shell completions for apps built using `System.CommandLine`.

Daily builds are available if you add this feed to your nuget.config: https://dotnetfeed.blob.core.windows.net/dotnet-core/index.json.

Interactive tutorials

You can try out System.CommandLine using an interactive tutorial that showcases its features and APIs, powered by Try .NET.

To use the tutorial, first clone the command-line-api repository:

> git clone https://github.com/dotnet/command-line-api

Next, install the dotnet try global tool:

> dotnet tool install -g dotnet-try

Finally, launch the dotnet try pointing to the tutorial directory inside the cloned repository:

> dotnet try <PATH_TO_COMMAND_LINE_API_REPO>/samples/tutorial

This project has adopted the code of conduct defined by the Contributor Covenant to clarify expected behavior in our community. For more information, see the .NET Foundation Code of Conduct

See the Contributing guide for developer documentation.

This project is licensed under the MIT license.

.NET is a .NET Foundation project.