Arguments (positional)

Mark a parameter with [Argument] to make it positional. Indices must start at 0 and be consecutive.

public static Task<int> Deploy([Argument] string environment) { … }
// myapp deploy production
		

Combine [Argument] with a T[] type (or params T[]) to collect all remaining tokens into an array. The variadic argument must be the last positional. Zero items is valid.

Because C# requires params to be the last method parameter, a variadic positional can appear after flags in the method signature.

public static void Copy([Argument] string dest, [Argument] params string[] files) { … }
// myapp copy ./out/ a.txt b.txt "path with spaces/c.txt"
		

Flags can appear before or after variadic tokens on the command line:

public static void Archive([Argument] params string[] files, bool verbose = false) { … }
// myapp archive a.zip b.zip --verbose
		

Mixed scalar positional, flags, and variadic arguments work together. Note that params must be the last C# parameter:

public static void Tag([Argument] string target, bool force, [Argument] params string[] tags) { … }
// myapp tag main-branch --force tag1 tag2 tag3
		

Variadic positionals appear as <files...> / [<files...>] in --help and include a [variadic] annotation.

Apply [MinLength(n)] or [MaxLength(n)] to validate the item count:

public static void Archive([Argument][MinLength(1)][MaxLength(20)] string[] files) { … }
// --help: <files...>   [variadic] [count: 1–20]