citty

What problem does it solve?

Provides a compact, TypeScript-first framework for defining and running command-line interfaces so developers can avoid boilerplate argument parsing, subcommand wiring, and lifecycle management while keeping zero runtime dependencies.

Core Features & Use Cases

• Declarative command definitions: defineCommand expresses metadata, arguments, subcommands, and lifecycle hooks in a single typed object.
• Flexible dispatch modes: runMain handles real processes with help/version handling and exits, while runCommand supports programmatic invocation for testing.
• Lazy and async subcommands: load heavy command implementations on demand via functions or dynamic imports to speed startup.
• Use Case: Create installer or developer tooling CLIs that require positional and boolean options, nested subcommands, consistent help output, and safe cleanup hooks.

Quick Start

Declare your command with defineCommand including args and subCommands, then invoke runMain(main) to parse argv and dispatch.