color-cli-log

Colorized CLI logger for Node.js. Prints ISO timestamps, level labels, and icons to console with ANSI colors.

Install

npm install color-cli-log

Usage

const logger = require("color-cli-log");
// or: const { logger } = require("color-cli-log");

logger.info("Server listening on port 3000");
logger.warn("Deprecated option used");
logger.error("Request failed", err);

ESM

import logger from "color-cli-log";
import { logger } from "color-cli-log";

logger.debug("cache hit");

Dynamic level

logger.log("info", "same as logger.info()");

API

Default export and named export logger are the same singleton.

| Method | Writes to | |--------|-----------| | trace(message, ...args) | console.log | | debug(message, ...args) | console.log | | info(message, ...args) | console.log | | warn(message, ...args) | console.warn | | error(message, ...args) | console.error | | fatal(message, ...args) | console.error | | log(level, message, ...args) | dispatches by level |

level is one of: trace, debug, info, warn, error, fatal.

Additional arguments are passed through to the underlying console method after the formatted message (same pattern as console.log).

Output

Each line includes:

• ISO 8601 timestamp in brackets
• A level-specific icon
• Uppercase level name (padded)
• Your message (with ANSI colors per level; terminals without color support may show escape codes unless you disable them elsewhere)

TypeScript

Types are published under dist/index.d.ts via the types field in package.json.

Development

npm install
npx tsc

Compiled output goes to dist/. Configure a build script in package.json if you want npm run build to run tsc.

Maintainer note

index.ts imports ./logger for the LogLevel type and loads that module at runtime. Before publishing, review logger.ts and remove any code you do not intend to run on every require("color-cli-log").

License

MIT © pedrorestiffo