minimist
minimist: A focused, free parser for Node.js argv handling when subcommands and config are unnecessary. Ranked #53 of 60 in Command-Line Interface Frameworks by our editors (3.9/10); pricing: Free plan; best for minimal Node.js argv parsing.
At a glance
- Editor score3.9 / 10
- PricingFree plan
- Best forMinimal Node.js argv parsing
- Free planYes
- Paid fromFree
- Facts checked17 Nov 2026
Where it wins
- Parses short and long options into a command-line argv object
- Supports aliases, defaults, booleans, strings, negation, and numeric conversion
- Handles stopEarly parsing, unknown-option callbacks, and arguments after --
Where it doesn't
- Does not provide built-in subcommand routing or shell completion
- Does not include configuration-file management or a broad typed API
- Support is provided through documentation and community channels
Our verdict on minimist
minimist is a small, open-source JavaScript module that turns command-line argument arrays into an options object. It is aimed at developers building Node.js command-line programs, from solo projects to enterprise codebases that need direct argument parsing. The package is distributed through npm and supports both CommonJS and ES module usage, making it a focused building block rather than a complete command-line application framework.
Its open-source model includes a free plan, with no paid tier structure to compare. The parser covers common option-handling needs: short and long syntax, aliases, default values, explicit string and boolean typing, negated options such as --no-foo, and conversion of numeric-looking arguments to numbers. Additional controls include stopEarly parsing, unknown-option callbacks, and handling values that follow a double dash. This breadth is useful when a command needs predictable argv normalization without extra framework layers.
The trade-off is narrow scope. minimist does not cover subcommands, shell completion, configuration management, or a broader typed command-line API, so projects needing those capabilities should consider a more expansive framework. Deployment is self-hosted as an npm library, and support channels are documentation and community rather than a hosted service. Choose minimist when a lightweight parser is the main requirement; choose an alternative when command discovery, generated interfaces, or integrated configuration are central to the product.
Your product? Our editors can test minimist in depth and publish a review, labelled as paid · from $149/mo →
minimist pricing
minimist fact sheet
| Free plan | Yes |
|---|---|
| Paid from | Free |
| Shell completion | Not verified |
| Nested subcommands | Not verified |
| Code generation | Not verified |
| Config file support | Not verified |
| Environment variables | Not verified |
| Typed API | Not verified |
| Deployment | Self-hosted |
| Support | Docs, Community |
| Built for | Solo, Small business, Mid-market, Enterprise (editorial estimate) |
| Pricing | Free plan |
| Website | github.com |
| Facts checked | 17 Nov 2026 |
Alternatives to minimist
- ClapA free Rust crate with typed parsing, nested commands, validation, and completions.9.4
- ClickA free, open-source toolkit for typed, nested Python command-line applications.9.3
- TyperFree, open-source typed CLI framework with nesting, completions, and configuration support.9.2
See all minimist alternatives →
Used minimist? Be the first to review it
The editor score above is our own research. What this page doesn't have yet is a reader's view — what you used minimist for, what worked and what didn't. No stars are seeded and no review is paid for; an editor reads every one before it appears.
Write a reviewTwo minutes · verified accounts only · read by an editor before it appears
Featured on iTechGuides
minimist is listed in our Command-Line Interface Frameworks directory. Add the badge to your site — it links back to this page.
<a href="https://www.itechguides.com/products/minimist/"><img src="https://www.itechguides.com/best/badge/minimist.svg" alt="Featured on iTechGuides" width="230" height="46"></a>
Reviewed by iTechGuides Editors · Editorial team · Updated Nov 2026
Advertiser disclosure: iTechGuides is reader-supported. Vendors can pay for top positions in our rankings and for a place on other products' pages, and we may earn a commission when you click some links. Bought places stand at the number bought; this page and our disclosure say so. Paying vendors may get a fuller, more detailed review from our editors, and that review can change their score. How we rank.
Last updated · How we research and update