agent-debugger

Attach to running Python servers by PID and inspect runtime state.

3|Updated Dec 22, 2025
One-click install
npx skills add https://github.com/JoaquinCampo/Skills --skill agent-debugger-joaquincampo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-debugger
Source: https://github.com/JoaquinCampo/Skills/tree/main/agent-debugger
Command: npx skills add https://github.com/JoaquinCampo/Skills --skill agent-debugger-joaquincampo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Use when a program crashes, a test fails, or code produces wrong results and reading the source isn't enough to see why. Lets you pause execution at any line and inspect the actual runtime state, variable values, types, call stacks, to find what went wrong. Can attach to running servers by PID — no restart or code changes needed.

Core Features & Use Cases

  • Breakpoints and live inspection of runtime state with eval-focused workflow.
  • Attach to running servers by PID or port; diagnose issues without code changes.
  • Inspector commands: vars, stack, source, and break management to test hypotheses quickly.

Quick Start

Attach to a running process, pause execution, and inspect runtime state to diagnose and fix issues without restarting code.

Frequently Asked Questions about agent-debugger

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

FAQPage Schema
How do I debug a running Python server by PID without restarting it?

To debug a running Python server by PID without restarting, attach the debugger directly to the process. This pauses execution at breakpoints, letting you inspect runtime state, variables, and stack traces to diagnose crashes live.

Can I inspect variables and evaluate expressions at runtime during debugging?

Yes, you can inspect variables and evaluate expressions at runtime. Once execution pauses at a breakpoint, the eval-focused workflow lets you test hypotheses quickly by viewing vars, stack traces, and source code.

What is the best way to diagnose a crashed process or failed test in real time?

The best way to diagnose a crashed process or failed test in real time is attaching a debugger to pause execution. You can inspect the call stack, view variable values, and evaluate expressions to find exactly what went wrong.

Do I need to manually install a debugging environment to attach to a server?

No, you do not need to manually install a debugging environment to attach to a server. The debugger auto-installs the required environment when needed, handling attach-by-pid or attach-by-port workflows seamlessly.

Does this runtime debugging approach work with runtimes other than Python servers?

Yes, runtime debugging works with runtimes other than Python servers. It supports other environments via adapters, allowing you to attach by PID or port to diagnose unexpected behavior across different supported runtimes.