node-inspect-debugger

Debugs Node.js programs via V8 inspect and Chrome DevTools Protocol.

Updated May 15, 2026
One-click install
npx skills add https://github.com/cabezno/bmb-encover-agent --skill node-inspect-debugger-cabezno
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: node-inspect-debugger
Source: https://github.com/cabezno/bmb-encover-agent/tree/main/skills/software-development/node-inspect-debugger
Command: npx skills add https://github.com/cabezno/bmb-encover-agent --skill node-inspect-debugger-cabezno

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires chrome-remote-interface.

What problem does it solve?

It helps you debug Node.js runtime behavior when console output is insufficient by letting you pause execution, set real breakpoints, and inspect local and closure state.

Core Features & Use Cases

  • Interactive breakpoint debugging: Use the built-in node inspect REPL to continue, step, list source, and backtrace to find where values become wrong.
  • Scoped state inspection: Inspect locals and closure variables and evaluate expressions in the paused frame.
  • Automated CDP-driven debugging: Use chrome-remote-interface to script breakpoints by URL/line, dump properties from scopes, and run repeatable debugging workflows for CI-like repros.

Use Case: A TypeScript/Ink-based TUI behaves incorrectly—pause on the suspect render or async chain, inspect component props/state, and confirm how the execution path reaches the failing logic.

Quick Start

Attach the debugger to a running process, then pause and set a breakpoint at the line where you expect the bug to occur by running: node inspect -p <pid>.

Frequently Asked Questions about node-inspect-debugger

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

FAQPage Schema
How do I debug Node.js async logic when console logs aren't showing the execution flow?

Debug Node.js async logic by attaching the V8 inspector to pause execution, set real breakpoints, and inspect local and closure state. This reveals hidden execution paths and variable values that console output cannot capture.

Can I attach the Node.js inspector to an already running process?

Yes, you can attach the Node.js inspector to an existing process by running node inspect -p <pid>. This connects the debugger to the live process so you can pause execution and inspect its current state.

How do I inspect closure variables in a paused Node.js frame?

Inspect closure variables in a paused Node.js frame by using the built-in node inspect REPL. Once execution is paused at a breakpoint, you can evaluate expressions and examine local and closure scope values directly.

Does chrome-remote-interface work for automating Node.js debugging workflows in CI?

Yes, chrome-remote-interface scripts CDP automation for Node.js debugging, allowing you to programmatically set breakpoints by URL/line, dump properties from scopes, and run repeatable debugging workflows for CI-like repros.

What's the best way to debug a TypeScript TUI that renders incorrect component state?

The best way is to use breakpoint-driven analysis with the V8 inspector. Pause execution on the suspect render or async chain, inspect component props and state, and confirm how the execution path reaches the failing logic.

Why use Chrome DevTools Protocol instead of the node inspect REPL for debugging?

Use Chrome DevTools Protocol via chrome-remote-interface when you need non-interactive, scriptable debugging automation. The node inspect REPL is better suited for interactive, manual breakpoint analysis and stepping through code.