CLI frameworks for TypeScript: complete overview and code examples

CLI frameworks for TypeScript: building powerful console applications

Modern TypeScript development is unthinkable without command-line tools (CLI). Whether it's project building, code generation, or task automation — a quality CLI interface boosts developer productivity. In this article, we will review the best frameworks for creating CLI in TypeScript, their features, and provide practical examples.

Why do you need a CLI framework?

Creating a CLI from scratch is a labor-intensive task. Frameworks provide ready-made solutions for:

• Parsing command-line arguments
• Creating command hierarchies (subcommands)
• Automatic help generation (--help)
• Error handling and input validation
• Interactive prompts (autocomplete)
• Colored output and progress bars

Top CLI frameworks for TypeScript

1. Commander.js

The most popular framework for Node.js CLI. It stands out for its simplicity and flexibility. Great for projects of any size.

import { Command } from 'commander';

const program = new Command();

program  .name('my-cli')  .description('Example CLI application')  .version('1.0.0');

program  .command('greet')  .argument('<name>', 'User name')  .option('-l, --language <lang>', 'Greeting language', 'ru')  .action((name, options) => {    const greetings: Record<string, string> = {      ru: `Hello, ${name}!`,      en: `Hello, ${name}!`,      es: `¡Hola, ${name}!`,    };    console.log(greetings[options.language] || greetings['ru']);  });

program.parse(process.argv);

Advantages of Commander:

• Intuitive API
• TypeScript support out of the box
• Easy integration with other libraries
• Large community and documentation

2. Ink (React for CLI)

A unique framework that allows building CLI interfaces using React components. Ideal for interactive applications with rich UI.

import React, { useState } from 'react';import { render, Text, Box, useInput } from 'ink';

const Counter = () => {  const [count, setCount] = useState(0);

  useInput((input) => {    if (input === 'q') process.exit(0);    if (input === '+') setCount(c => c + 1);    if (input === '-') setCount(c => c - 1);  });

  return (    <Box flexDirection="column" alignItems="center">      <Text color="green" bold>Counter: {count}</Text>      <Text dimColor>Press + or - to change, q to exit</Text>    </Box>  );};

render(<Counter />);

Advantages of Ink:

• Component-based approach (familiar to React developers)
• Automatic interface updates
• Support for animations and progress bars
• Flexible output customization

3. Oclif (Heroku CLI Engine)

A framework from the creators of Heroku CLI. It offers a powerful project generator and built-in plugin support. Great for enterprise solutions.

import { Command, Flags } from '@oclif/core';

export class Greet extends Command {  static description = 'User greeting';

  static flags = {    name: Flags.string({ char: 'n', description: 'Name', required: true }),    uppercase: Flags.boolean({ char: 'u', description: 'Uppercase' }),  };

  async run(): Promise<void> {    const { flags } = await this.parse(Greet);    let message = `Hello, ${flags.name}!`;    if (flags.uppercase) message = message.toUpperCase();    this.log(message);  }}

Advantages of Oclif:

• Automatic CLI generation (via npx oclif generate)
• Built-in testing system
• Support for hooks and plug