node-inspect-debugger

node-inspect-debugger is a skill for Claude Code, Codex from BlackBeltTechnology/pi-agent-dashboard. It costs 83 tokens per session (1,962 once invoked), scanned A, original, MIT.

A debugger for Node.js and TypeScript programs that lets you pause execution at a breakpoint, inspect variables and closures, step through code, and view the call stack. Node.js is a runtime for running JavaScript outside a browser.

In plain words
What is it for?
Use it to investigate request handlers, process restarts, terminal workers, WebSocket connections, and other bugs that depend on hidden runtime state.
Why use it?
It reveals live program state that adding console.log statements may miss, especially inside asynchronous code, workers, servers, or long-lived connections.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/blackbelttechnology/pi-agent-dashboard/node-inspect-debugger
Any agent
npx skills add BlackBeltTechnology/pi-agent-dashboard --skill node-inspect-debugger
Clone the repo
git clone --depth 1 https://github.com/BlackBeltTechnology/pi-agent-dashboard

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for node-inspect-debugger

README.md
[![agentmods](https://agentmods.dev/badge/skills/blackbelttechnology/pi-agent-dashboard/node-inspect-debugger.svg)](https://agentmods.dev/skills/blackbelttechnology/pi-agent-dashboard/node-inspect-debugger)
Your own site
<a href="https://agentmods.dev/skills/blackbelttechnology/pi-agent-dashboard/node-inspect-debugger"><img src="https://agentmods.dev/badge/skills/blackbelttechnology/pi-agent-dashboard/node-inspect-debugger.svg" alt="Measured on agentmods" height="20"></a>
Per session 83 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,962 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 1 finding. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00083 $0.01962
Opus 5 $0.00042 $0.00981
Sonnet 5 $0.00017 $0.00392
Haiku 4.5 $0.00008 $0.00196

Measured 4d ago against content hash 0843b53ab597, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

node-inspect-debugger scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 4d ago.

The scan reads SKILL.md. This mod also ships 1 executable file (scripts/cdp-inspect.ts), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

curl -s http://127.0.0.1:<port>/json/list # find the webSocketDebuggerUrl / port
packages/eng-disciplines/.pi/skills/node-inspect-debugger/SKILL.md · 136 lines

How it starts

The opening of the file, as written. The whole thing — 136 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Node Inspect Debugger

Overview

console.log is a guess with a print statement attached — you have to already suspect where to look and what to print. A breakpoint inverts that: you stop the world at a line and read every local and closure variable in the frame, walk the call stack, and evaluate expressions in the paused context. When the bug lives in state a log can't cheaply reach — a closure captured three calls ago, a paused async frame, the Electron main process, the internals of a long-lived WebSocket server — the inspector is the tool.

This skill is the TOOL half of a pair; the METHOD is systematic-debugging (its Phase 1 "gather evidence" and Phase 3 "test one variable" are exactly when you reach for a breakpoint).

When to Use

Reach for the inspector when the state you need is expensive or impossible to log:

  • The jiti server (packages/server, TypeScript run directly via jiti) — request handlers whose failure depends on accumulated in-memory state.
  • The restart orchestrator / PTY workers (restart-helper.ts) — a detached process whose closure state you can't console.log from the parent.
  • Dual WebSocket server closure state — connection maps and buffers held in closures across the bridge and browser servers.
  • The Electron main process — lifecycle/bootstrap state that never reaches a browser console.
  • The bridge extension — code running inside every pi session, where adding logs means reloading every session.

If a single well-placed console.log would answer the question, use the log. The inspector earns its setup cost when the state is deep, closure-bound, or in a process you can't easily instrument.

Two tiers

Tier Use when Interface
REPL (node inspect) interactive, one-off, you're driving the node inspect command REPL
Programmatic CDP scripted, repeatable, or attaching from another process scripts/cdp-inspect.ts (this skill)

Read the full file on GitHub · 136 lines

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 4d ago First seen · 136 lines · 83 tokens per session scan A 0843b53ab597

Subscribe to this mod's changes

node-inspect-debugger is a skill published in the GitHub repository BlackBeltTechnology/pi-agent-dashboard (271 stars, last pushed yesterday), licensed MIT. It adds 83 tokens to every session and 1,962 once invoked, about $0.0004 per session on Opus 5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.