node-inspect-debugger

Debug Node.js runtime issues using the native inspector and Chrome DevTools Protocol.

Updated May 7, 2026
One-click install
npx skills add https://github.com/MOODMNKY-LLC/mnky-atlas --skill node-inspect-debugger-moodmnky-llc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: node-inspect-debugger
Source: https://github.com/MOODMNKY-LLC/mnky-atlas/tree/main/skills/node-inspect-debugger
Command: npx skills add https://github.com/MOODMNKY-LLC/mnky-atlas --skill node-inspect-debugger-moodmnky-llc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the frustration of debugging hard-to-reproduce Node.js issues like async hangs, memory leaks, child process crashes, and flaky tests that cannot be diagnosed with basic console logging.

Core Features & Use Cases

  • Built-in REPL Debugging: Step through code, set breakpoints, and inspect local scopes using the native node inspect tool without additional setup.
  • CDP Automation: Script breakpoints, capture heap snapshots, and generate CPU profiles via Chrome DevTools Protocol for complex, repeatable debugging workflows.
  • Use Case: Debug a failing Vitest test by pausing on entry, inspecting async call stacks to find race conditions, and capturing a heap snapshot to identify unexpected memory growth between test runs.

Quick Start

Use the node-inspect-debugger skill to attach to a running Node.js process by PID, set a breakpoint on a target function, and capture a CPU profile to identify performance hot paths.

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 a Node.js async hang or memory leak when console logging isn't enough?

Capture a heap snapshot via Chrome DevTools Protocol automation to compare memory states before and after test runs. This identifies unexpected memory growth and objects retained between executions, revealing leaks that flaky Vitest tests often obscure.

How do I attach a Node.js debugger to a running process by PID?

Attach the native node inspect tool to a running Node.js process by its PID to set breakpoints and capture CPU profiles. This connects the debugger to live applications, enabling step-through execution and performance profiling without additional setup.

Can I automate Chrome DevTools Protocol to capture CPU profiles and heap snapshots?

Yes, you can script Chrome DevTools Protocol automation to programmatically set breakpoints, capture heap snapshots, and generate CPU profiles. This enables repeatable debugging workflows to identify performance hot paths and memory leaks in Node.js applications.

What is the best way to find race conditions causing flaky Node.js test failures?

Debug flaky Node.js test failures by pausing on test entry with the native inspector and inspecting async call stacks to find race conditions. Step-through debugging reveals timing issues that standard test runners cannot identify.

Does the native node inspect tool support debugging child process crashes?

Yes, the native node inspect tool supports resolving hard-to-diagnose Node.js runtime issues including child process crashes. It enables inspector access and breakpoint management to step through code where the child process fails.

When should I use CPU profiles instead of standard logging for Node.js performance issues?

Use CPU profiles when standard logging cannot identify performance hot paths in Node.js applications. Generating a CPU profile via the inspector captures detailed runtime execution data, revealing bottlenecks that logs fail to expose.