EasyCLI

The modern framework for building type-safe, beautiful CLI applications.

A complete replacement for Commander.js + Inquirer with better DX.

Features | Quick Start | Documentation | Tutorial

---

Quick Start

npx create-easycli my-app
cd my-app
pnpm dev hello World

---

Features

Feature	Description
Type Safety	Full TypeScript inference from schema to handler
UI Components	Colors, spinners, progress bars, tables, boxes
Prompts	Text, password, confirm, select, multiselect
Signal Handling	Graceful SIGINT/SIGTERM with cleanup hooks
Input Sanitization	Built-in injection attack protection
Array Flags	--file a.ts --file b.ts collects into arrays
Optional Args	{ type: "string", optional: true }
Subcommands	cli db migrate, cli db seed
Rich Errors	Errors with hints and exit codes

---

Example

import{defineCLI}from"easycli-core";import{colors,spinner,box}from"easycli-ui";constcli=defineCLI({name: "deploy-cli",version: "1.0.0",commands: {up: {description: "Deploy to environment",args: {env: ["staging","production"]},flags: {force: {type: "boolean",alias: "f"},file: {type: "string",array: true,alias: "F"}},asyncrun({ env, force, file },ctx){if(!force){constproceed=awaitctx.ask.confirm(`Deploy to ${env}?`);if(!proceed)return;}consts=spinner(`Deploying ${file?.length||0} files to ${env}...`);s.start();awaitdeploy(env);s.success("Deployed!");console.log(box(`Environment: ${colors.cyan(env)}`,{borderStyle: "rounded",borderColor: "green"}));}}}});cli.run();

Usage:

deploy-cli up production --force --file api.ts --file worker.ts

---

Packages

Package	Description	Install
easycli-core	CLI definition, parsing, routing	pnpm add easycli-core
easycli-ui	Colors, spinners, progress, tables, boxes	pnpm add easycli-ui
easycli-prompts	Interactive prompts, sanitization	pnpm add easycli-prompts
easycli-help	Help text generation	pnpm add easycli-help
easycli-config	Config file loading	pnpm add easycli-config
easycli-plugins	Plugin system	pnpm add easycli-plugins
create-easycli	Project scaffolder	npx create-easycli

---

UI Components

Colors

import{colors}from"easycli-ui";console.log(colors.green("Success!"));console.log(colors.bold(colors.red("Error!")));console.log(colors.bgCyan(colors.white("Highlight")));

Spinner

import{spinner}from"easycli-ui";consts=spinner("Loading...");s.start();awaitdoWork();s.success("Done!");

Progress Bar

import{progress}from"easycli-ui";constbar=progress(100);for(leti=0;i<=100;i+=10){bar.update(i);awaitdelay(100);}bar.complete();

Table

import{table}from"easycli-ui";table([{Name: "api",Status: "Running",Port: 3000},{Name: "worker",Status: "Stopped",Port: 3001}]);

Box

import{box}from"easycli-ui";console.log(box("Hello World!",{title: "Greeting",borderStyle: "rounded",borderColor: "cyan",padding: 1}));

---

Documentation

Document	Description
Getting Started	Setup in 5 minutes
Tutorial	Build a CLI from scratch
API Reference	Complete API docs
Building Beautiful CLIs	Full feature guide
Why EasyCLI?	Framework comparison

---

Examples

Example	Description
simple-app	Basic CLI with one command
myapp	Full-featured demo
test-features	Tests all production features
deploy-cli	Deployment tool example

---

Contributing

Contributions welcome! Please read CONTRIBUTING.md.

---

License

MIT - Avijit