@zokugun/cli-utils

A small collection of focused utilities to build user-friendly Node.js command-line applications.

It bundles lightweight helpers so you can compose rich CLI interactions without pulling in many separate packages:

• colored output (https://github.com/doowb/ansi-colors)
• spinner frames (https://github.com/sindresorhus/cli-spinners)
• prompt utilities (https://github.com/enquirer/enquirer)
• a tiny commander wrapper (https://github.com/tj/commander.js)
• a simple logger (use https://github.com/zokugun/node-log-update-plus)

Compatible with Node.js 18.x.

Installation

npm install @zokugun/cli-utils

Quick Start

import { logger } from '@zokugun/cli-utils';

logger.begin(); // start timer

logger.progress('Starting task'); // use spinner to indicate progress

logger.success('Task finished');

logger.finish(); // print "🏁 Done (in 1s)."

Quick Reference

• ansi-colors: small helpers for colored and styled terminal output.
• cli-spinners: common spinner frame sets and metadata for progress indicators.
• commander: thin convenience exports for building CLI commands.
• enquirer: prompt helpers for interactive prompts (+ patch and confirm, Invisible).
• logger: simple logging helpers for consistent CLI output.

Module entry points

Choose the entry point that matches your environment and naming preferences:

Import path	Description
@zokugun/cli-utils	All utilities
@zokugun/cli-utils/ansi-colors	colors from ansi-colors
@zokugun/cli-utils/cli-spinners	spinners from cli-spinners
@zokugun/cli-utils/commander	tiny command from commander
@zokugun/cli-utils/enquirer	prompt utilities from enquirer
@zokugun/cli-utils/logger	the logger

Donations

Support this project by becoming a financial contributor.

	ko-fi.com/daiyam
	liberapay.com/daiyam/donate
	paypal.me/daiyam99

License

Copyright © 2026-present Baptiste Augrain

Licensed under the MIT license.