Skills

Debug Logging Setup

Configures debug() logging namespaces and formats through DEBUG settings.

Install

npx skills add lobehub/lobehub --skill debug-package -g -a claude-code -y
Repository
lobehub/lobehub83.7k
Category
Engineering
Updated
3d ago
License
See repository
Context cost
Lightabout 244 tokens
Runs scripts
No, instructions only

What it does

Use for debug() logging, lobe-* namespaces, DEBUG/localStorage.debug configuration and log formatting.

Debug Package Usage Guide

Basic Usage

import debug from 'debug';

// Format: lobe-[module]:[submodule]
const log = debug('lobe-server:market');

log('Simple message');
log('With variable: %O', object);
log('Formatted number: %d', number);

Namespace Conventions

  • Desktop: lobe-desktop:[module]
  • Server: lobe-server:[module]
  • Client: lobe-client:[module]
  • Router: lobe-[type]-router:[module]

Format Specifiers

  • %O - Object expanded (recommended for complex objects)
  • %o - Object
  • %s - String
  • %d - Number

Enable Debug Output

Browser

localStorage.debug = 'lobe-*';

Node.js

DEBUG=lobe-* bun run dev
DEBUG=lobe-* pnpm dev

Electron

process.env.DEBUG = 'lobe-*';

Example

// apps/server/src/routers/lambda/agentEval.ts
import debug from 'debug';

const log = debug('lobe-lambda-router:agent-eval');

log('getAgent input: %O', input);

More in Engineering