@qnx/log

@qnx/log provides a console logger using the Chalk library for colorful output. It supports different message types — info, success, warn, error, debug, and trace — each rendered in a distinct color.

🤖 MCP Server: https://qnx-mcp-server.vercel.app/mcp/log

Node.js: chalk is ESM-only, so require('@qnx/log') needs Node.js 20.19+ or 22.12+. import has no such limit. chalk 6 itself needs Node.js 22+, so use chalk 5 on older versions.

✨ Features

• 🎨 Colorized console output via Chalk
• 📢 Six built-in message types: info, success, warn, error, debug, trace (warning still works as a deprecated alias of warn)
• 🛠️ Simple, minimal API

📦 Installation

# npm
npm install @qnx/log

# yarn
yarn add @qnx/log

# pnpm
pnpm install @qnx/log

Peer Dependencies

npm install chalk

🚀 Usage

import { consoleLog } from '@qnx/log'

consoleLog('Server started', { type: 'info' })        // ⓘ  Server started
consoleLog('Operation successful', { type: 'success' }) // ✓  Operation successful
consoleLog('Proceed with caution', { type: 'warn' })    // ⚠  Proceed with caution
consoleLog('An error occurred!', { type: 'error' })     // ✗  An error occurred!
consoleLog('Fetching user data...', { type: 'debug' })  // ◇  Fetching user data...
consoleLog('Request ID: 7f3a2b1e', { type: 'trace' })   // ☆  Request ID: 7f3a2b1e

Pass an Error (for example, straight from a catch block) to print its stack trace and cause chain:

try {
    await connect()
} catch (err) {
    consoleLog(err, { type: 'error' })
}
// ✗  Error: Failed to connect to database
//     at connect (db.ts:12:11)
// Caused by: Error: ECONNREFUSED 127.0.0.1:5432
//     at ...

Other values (objects, numbers, …) are converted to text; plain objects are JSON-formatted.

The type option defaults to 'info' if omitted:

consoleLog('This is an informational message')

🤖 MCP Server

AI tools for this package are available via the QNX MCP Server.

Endpoint: https://qnx-mcp-server.vercel.app/mcp/log

| Tool | Description | | ---- | ----------- | | get-console-log-docs | Documentation for usage, message types, and patterns | | build-console-log | Preview console output and get the consoleLog() call |

Supported clients: Claude Desktop · Claude Code · Cursor · Windsurf · Cline · Continue.dev · Codex CLI · ChatGPT Desktop

HTTP (Streamable HTTP)

{
  "mcpServers": {
    "qnx-log": {
      "url": "https://qnx-mcp-server.vercel.app/mcp/log"
    }
  }
}

stdio (via npx)

{
  "mcpServers": {
    "qnx-log": {
      "command": "npx",
      "args": ["-y", "@qnx/mcp", "log"]
    }
  }
}

🤝 Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change. Please make sure to update tests as appropriate.

📄 License

MIT License © 2023-PRESENT Yatendra Kushwaha