Skip to content

HelpOptions ​

Options for customising help output.

Signatures ​

ts
interface HelpOptions {}

Members ​

Properties ​

binName ​

Binary/program name shown in the usage line. Defaults to command name.

ts
binName?: string;

colors ​

Gated ANSI palette used to style help output. Identity formatters mean plain text. CLIBuilder.execute()/.run() thread the output channel's out.color here automatically, so styling follows the same policy as handler output (TTY + color support, no --json, NO_COLOR honored).

ts
colors?: Colors;

Show the Run '<bin> <command> --help' for more information. footer.

Defaults to showing the hint only when visible subcommands exist; set explicitly to force it on or off.

ts
footer?: boolean;

Emit OSC 8 hyperlinks where link metadata is available (currently the root-help header name/version configured via CLIBuilder.links()). Defaults to false; CLIBuilder.execute()/.run() enable it automatically when stdout is a TTY.

ts
hyperlinks?: boolean;

inlineDefault ​

Render the default command's arguments and flags inline in root help.

Only affects root-level help. When false, root help lists commands and defers default-command details to <bin> --help-style hints.

ts
inlineDefault?: boolean;

isDefaultHelp ​

Whether this usage line is being rendered as merged root/default help.

ts
isDefaultHelp?: boolean;

showDefaultInCommands ​

List the default command in the root Commands: table.

By default the default command is treated as the root surface and omitted from the command list (its args/flags render inline instead).

ts
showDefaultInCommands?: boolean;

theme ​

Theme overrides merged over the built-in help theme. Receives the gated palette; never invoked when color is off, so overrides cannot leak escapes into piped output.

ts
theme?: HelpThemeFactory;

width ​

Maximum line width (columns). Defaults to 80.

ts
width?: number;

See Also ​

Released under the MIT License.