CLI tools often need readable tables that fit the current terminal, stay useful when piped, and do not repeat low-level cli-table3 styling at every call site. @andreas-timm/cli-table centralizes those defaults while keeping table rendering explicit and API-only.

Features

Borderless table output for terminal and piped CLI text.
Smart column sizing with fixed, percent, content-fit, and fill columns.
Optional word wrapping plus full-width inserted detail lines.
Small rendering API only; callers keep control of their own CLI flags and option parsing.

Install

npm install @andreas-timm/cli-table

Usage

import { createTable, isPipedOutput } from '@andreas-timm/cli-table';

const table = createTable({
    tableWidth: isPipedOutput() ? 'full' : 'terminal',
    wordWrap: true,
    columns: [
        { index: 0, width: 6, align: 'right' },
        { index: 1, widthPercent: 25 },
        { index: 2, fit: 'fill' },
    ],
});

table.push(['1', 'build', 'Long description']);
table.pushLine('Indented details wrap with the table when wordWrap is enabled.');

console.log(table.toString());