debug-package

Configure debug package loggers with lobe namespace conventions and environment variables.

1|Updated May 20, 2026
One-click install
npx skills add https://github.com/mDevsLabs/mAI --skill debug-package-mdevslabs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug-package
Source: https://github.com/mDevsLabs/mAI/tree/main/.agents/skills/debug-package
Command: npx skills add https://github.com/mDevsLabs/mAI --skill debug-package-mdevslabs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This guide helps developers implement and troubleshoot log output by using the debug package and structured namespaces for clear, controlled debugging across modules.

Core Features & Use Cases

  • Namespace-based logging with lobe-desktop, lobe-server, lobe-client, and lobe-router to organize messages by environment.
  • Format and output control using standard format specifiers and browser/localStorage/debug or NODE_DEBUG-like environments to enable/disable logs.
  • Practical examples showing how to create a logger with a module namespace and emit messages for debugging during development.

Quick Start

Install the debug package, instantiate a logger with a module namespace, and start emitting log messages to verify output.

Frequently Asked Questions about debug-package

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I enable debug logging in a Node.js or Electron application?

Debug logging in Node.js or Electron is enabled by setting the DEBUG environment variable or process.env.DEBUG to filter specific namespaces, allowing you to control which module logs emit output during development.

What is the best way to organize debug logs across different environments?

Organizing debug logs across environments uses structured namespaces like lobe-desktop, lobe-server, lobe-client, and lobe-router, which categorize log output by module and platform for clear, controlled debugging.

How do I use format specifiers with the debug package for structured log output?

Format specifiers with the debug package format structured log output by applying standard string substitution patterns to your logger messages, ensuring variables are rendered correctly when namespaces are enabled.

Can I enable debug namespaces in the browser using localStorage?

Yes, browser debug namespaces are enabled by setting the localStorage.debug property to your desired namespace string, which activates the corresponding loggers in client-side environments like lobe-client.

Why are my debug logs not showing in the terminal even after configuration?

Debug logs may not show in the terminal if the DEBUG environment variable or process.env.DEBUG is not set to match your logger's namespace, or if the namespace conventions are incorrectly applied in your code.