ls-debug

Debug LiteSuite Electron webview, preload, IPC, and bridge layers with disk logging and live monitoring.

Updated Aug 5, 2026
One-click install
npx skills add https://github.com/ahostbr/liteharness --skill ls-debug
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ls-debug
Source: https://github.com/ahostbr/liteharness/tree/main/liteharness/catalog/skills/ls-debug
Command: npx skills add https://github.com/ahostbr/liteharness --skill ls-debug

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

ls-debug helps you stop guessing when LiteSuite’s Electron webview, preload, IPC, or bridging fails, by setting up persistent disk logging and a focused monitor so you can see exactly where the runtime breaks.

Core Features & Use Cases

  • Disk-backed runtime logging: Creates and writes to component-specific debug log files under your home directory to preserve evidence across runs.
  • Boundary visibility: Guides you to add logs at every handoff (main process managers/handlers, preload “console-message” forwarding, and webview-side error trapping) so failures become traceable.
  • Monitor-driven debugging loop: Provides filtered and full tail commands to watch for handshake timeouts, missing preload exposures, IPC non-firing events, and spawn/process issues during rebuild and launch.

Quick Start

Trigger the LiteSuite flow and use ls-debug to set up a component disk logger, tail the log while reproducing the issue, then fix the specific failure point revealed by the monitor output.

Frequently Asked Questions about ls-debug

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

FAQPage Schema
How do I debug a blank Electron webview when reading the code isn't enough?

To debug a blank Electron webview, you need persistent disk logging and live monitoring to capture runtime evidence. Add structured boundary logs at handoffs, forward webview console output to disk, and trap renderer errors early in the wrapper HTML to trace failures.

Why does my Electron preload bridge silently fail to expose APIs?

An Electron preload bridge silently fails when IPC messages or initialization events are missing. You can identify the exact failure point by adding boundary visibility logs and using a filtered monitor to tail disk-persistent debug files while reproducing the issue.

What is the best way to monitor IPC handshake timeouts during a rebuild?

The best way to monitor IPC handshake timeouts is using a monitor-driven debugging loop with filtered tail commands. This watches for missing preload exposures and non-firing events during rebuild and launch, revealing exactly where the runtime breaks.

How do I capture Electron renderer errors before the webview fully loads?

To capture Electron renderer errors before the webview loads, trap renderer errors early in the wrapper HTML. Forward webview console messages through the preload layer to disk-backed log files so failures become traceable across runs.

Can I use disk-persistent logging to fix stuck spinners in Electron webviews?

Yes, disk-persistent logging fixes stuck spinners in Electron webviews by preserving runtime evidence across runs. Component-specific debug log files under your home directory capture spawn failures and missing handshake events for a read-fix-repeat iteration.