Debug Package Usage Guide

SkillFiles & storage

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

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Debug Package Usage Guide skill

What this skill tells your AI

The instructions your AI receives, as published by find-xposed-magisk/lobe-chat in .agents/skills/debug-package/SKILL.md and read by ahel’s review.

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-* npm run dev
DEBUG=lobe-* pnpm dev

Electron

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

Example

// apps/server/src/routers/edge/market/index.ts
import debug from 'debug';

const log = debug('lobe-edge-router:market');

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

Signals

GitHub stars
30
Forks
9
Last commit
Sep 2026

Others that do the same job

Advanced
Catalog kind
skill
Gateway key
debug-package
Source
github.com/find-xposed-magisk/lobe-chat