OptiqueType-safe combinatorial CLI parser for TypeScript

Express CLI constraints in code structure,
not validation logic.

Composable by design

Build parsers from small functions and combine them with merge() for option groups and or() for alternatives. Parser components can be shared across commands while preserving type information.

Why parser combinators?

⚡

Automatic type inference

TypeScript infers result types from parser composition, including discriminated unions for subcommands and optional fields. Most code requires no manual type annotations.

See it in the tutorial

🎯

Option group constraints

or() lets you express mutually exclusive option groups at the type level. The constraint is encoded in the parser structure, so invalid combinations are rejected at parse time rather than in application code.

See the comparison

🐚

Shell completion

Generates completion scripts for Bash, zsh, fish, PowerShell, and Nushell from parser definitions. Completion suggestions for choice() values, subcommands, and inter-option dependencies stay current with the parser.

Shell completion docs

📄

Man page generation

@optique/man generates Unix man pages in standard man(7) roff format from parser definitions. Options, subcommands, and their descriptions are derived from the same structure that drives parsing.

Man page docs

📦

Integration packages

Packages for config files (@optique/config), environment variables (@optique/env), interactive prompts (@optique/inquirer), Zod and Valibot schemas, Git references, and Temporal dates.

Browse integrations