Back to Explore

yargs/cliui

GitHub
1 watchersOpen source

Last release: 3/17/2025

cliui is a Node.js (and Deno and ESM) helper for building formatted, multi-column command line interfaces. It provides a small layout DSL with methods like div and span to render text with alignment, padding, borders, and optional wrapping to a string.

Project status

  • Maintenance status: The repository has at least one upstream push on 2026-05-12, but the provided changelog snippets only show updates up to 2025-03, so active maintenance is suggested but not fully evidenced by the update history alone.
  • Update/release cadence: A quick pair of updates occurred in mid-March 2025 (v9.0.0 then v9.0.1 two days later), followed by a multi-year gap in the provided history (next shown update was v8.0.1 in 2022, and then nothing shown until the 2026 push).

AI summary generated Today

AI-generated from public sources. May be inaccurate. Report

Recent updates

  • v9.0.1

    3/17/2025

    v9.0.1 is a small release focused on fixing CommonJS compatibility. The only functional code change adds an export alias intended to make `require("cliui")` behave as expected in CJS environments.

  • v9.0.0

    3/16/2025

    v9.0.0 makes cliui ESM-only, and the package metadata and test/CI setup were updated accordingly. The implementation also changed how string widths and ANSI wrapping are handled, switching from an internal minimal string helper to the upstream string-width/strip-ansi/wrap-ansi dependencies.

    Breaking

  • v8.0.1

    10/1/2022

    Release v8.0.1 makes a dependency management change, moving rollup-plugin-ts out of runtime dependencies. The only code diff shown is within the package metadata (package.json) plus an updated changelog entry.

  • v8.0.0

    9/30/2022

    Release v8.0.0 primarily updates the supported Node.js versions and dependency versions. While the release notes mention dropping Node 10 to address CVE-2021-3807, the diff shows additional changes to the package metadata (Node engine requirement) and build tooling dependencies.

    BreakingSecurity

  • v7.0.4

    11/8/2020

    cliui v7.0.4 contains a documented Deno related fix for importing UIOptions from type definitions. The code changes also adjust the core TypeScript typings and defaulting behavior around UIOptions.wrap and the cliui() function argument handling.

    Breaking

  • v7.0.3

    10/16/2020

    Release v7.0.3 contains a small packaging fix related to Node.js 13.0 and 13.1 handling of the package.json exports field. The main code change adjusts how exports is structured, and the version bump is accompanied by a dependency update in package.json.

  • v7.0.2

    10/15/2020

    cliui v7.0.2 is a small maintenance release that primarily addresses Node 13 export resolution issues. The release notes mention an exports fallback fix, while the code diff also shows CI and release workflow changes plus devDependency upgrades.

  • v7.0.1

    8/16/2020

    cliui v7.0.1 makes a packaging/build metadata fix so the package "main" points to the compiled CommonJS entry at build/index.cjs. The release notes only mention this build/main correction.

  • v7.0.0

    8/16/2020

    cliui v7.0.0 modernizes the build and adds TypeScript-based support for ESM and Deno. The codebase also introduces new module entrypoints and a custom ANSI helper implementation to support environments where the original dependencies may not work as-is.

    BreakingFeatures

  • v6.0.0

    11/16/2019

    cliui v6.0.0 updates project dependencies and removes support for Node.js 6. This release is primarily a compatibility change, and it may require developers to upgrade their Node runtime to continue using the CLI UI utilities.

    Breaking