Suggestions appear as you type. Use the up and down arrows to choose one and Enter to open it.

Citty

Free#45 of 60 in Command-Line Interface Frameworks

Citty: A focused, typed framework for building composable Node.js command-line interfaces. Ranked #45 of 60 in Command-Line Interface Frameworks by our editors (4.7/10); pricing: Free plan; best for typeScript CLIs with composable command plugins.

4.7/10Editor score
Citty4.7 Visit Citty

At a glance

  • Editor score
    4.7 / 10
  • Pricing
    Free plan
  • Best for
    TypeScript CLIs with composable command plugins
  • Free plan
    Yes
  • Paid from
    Free
  • Facts checked
    17 Nov 2026
  • Where it wins

    • Typed definitions and parsing for positional, string, boolean and enum options
    • Nested subcommands support recursive and lazy loading
    • Lifecycle hooks, plugins and programmatic command APIs
  • Where it doesn't

    • Shell completion sits outside the documented feature set
    • Configuration-file and environment-variable bindings are outside its stated scope
    • Support is provided through documentation channels

Our verdict on Citty

Citty is an open-source command-line interface framework for Node.js, maintained by UnJS. It targets developers building typed command trees, from small utilities to larger CLIs with nested commands and reusable plugins. The project is distributed as the npm package `citty`, uses TypeScript-oriented command definitions, and is licensed under MIT. Its published fit spans solo developers, small teams, mid-market organizations and enterprises that want a library rather than a finished command application.

The open-source model provides a free plan and keeps the pricing story straightforward. Citty’s core is a typed `defineCommand` helper with parsing for positional, string, boolean and enum options. Commands can contain recursively defined or lazily loaded subcommands, while generated usage and help output reduce repeated interface wiring. Built-in `--help` and `--version` flags cover common command behavior. Setup and cleanup lifecycle hooks apply to commands, and composable plugins expose their own setup and cleanup hooks. The `runCommand` and `parseArgs` APIs also support programmatic control when a CLI needs to be embedded in a broader process.

Platform fit is centered on Node.js and the UnJS public GitHub repository, with documentation listed as the support channel. Citty is a good choice when typed command definitions, nested loading and plugin composition are the main requirements. Its scope is narrower for teams that expect shell completion, configuration-file handling or environment-variable bindings as built-in parts of the framework. Those projects should compare alternatives that prioritize those capabilities. Teams wanting a lightweight, MIT-licensed foundation for composable TypeScript-oriented commands should find Citty aligned with that focus.

Your product? Our editors can test Citty in depth and publish a review, labelled as paid · from $149/mo →

Citty pricing

Plans Free planFree Free to use — no paid tier required for the core job.
See plans on github.com

Citty fact sheet

Free planYes
Paid fromFree
Shell completionNot verified
Nested subcommandsYes
Code generationNot verified
Config file supportNot verified
Environment variablesNot verified
Typed APIYes
SupportDocs
Built forSolo, Small business, Mid-market, Enterprise (editorial estimate)
PricingFree plan
Websitegithub.com
Facts checked17 Nov 2026

Alternatives to Citty

See all Citty alternatives →

Used Citty? 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 Citty 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

Reviews come only from verified accounts. Sign in or create an account first — your e-mail is never shown.

Your rating

0 characters · at least 80, up to 3,000

Posted from your verified account. Reviews appear after an editor reads them, usually within two working days.

Featured on iTechGuides

Featured on iTechGuides — Citty 4.7/10

Citty 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/citty/"><img src="https://www.itechguides.com/best/badge/citty.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