# Debug Logging Setup

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

- Repository: https://github.com/lobehub/lobehub (83676 stars)
- Category: Engineering
- License: see repository
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add lobehub/lobehub --skill debug-package -g -a claude-code -y`
Codex: `npx skills add lobehub/lobehub --skill debug-package -g -a codex -y`
Cursor: `npx skills add lobehub/lobehub --skill debug-package -g -a cursor -y`
Gemini CLI: `npx skills add lobehub/lobehub --skill debug-package -g -a gemini-cli -y`

## Description

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

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Debug Package Usage Guide

## Basic Usage

```typescript
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

```javascript
localStorage.debug = 'lobe-*';
```

### Node.js

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

### Electron

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

## Example

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

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

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