python-debugpy

Debug Python applications with pdb and debugpy for local and remote inspection.

Updated May 5, 2026
One-click install
npx skills add https://github.com/iani-kuli/harness_bro --skill python-debugpy-iani-kuli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: python-debugpy
Source: https://github.com/iani-kuli/harness_bro/tree/main/.claude/skills/ported/python-debugpy
Command: npx skills add https://github.com/iani-kuli/harness_bro --skill python-debugpy-iani-kuli

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires debugpy, remote-pdb.

What problem does it solve?

This skill resolves complex runtime issues in Python applications by providing a structured approach to interactive debugging, stack inspection, and remote process attachment.

Core Features & Use Cases

  • Interactive Debugging: Utilize pdb for local step-through execution and variable inspection.
  • Remote Debugging: Attach to long-running processes or headless services using debugpy for DAP-compliant remote inspection.
  • Post-Mortem Analysis: Inspect the state of an application at the exact moment of a crash to identify root causes.

Quick Start

Use the python-debugpy skill to set a breakpoint in your code and initiate an interactive debugging session to inspect local variables.

Frequently Asked Questions about python-debugpy

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

FAQPage Schema
How do I debug a long-running Python process or headless service?

You can debug a long-running Python process by using debugpy to attach a DAP-compliant remote debugging session. This allows you to inspect call stacks and mutate state without restarting the service.

What is the best way to inspect the state of a Python application right after it crashes?

Post-mortem analysis is the best way to inspect a crashed Python application. This technique allows you to examine the exact state of the application at the moment of failure to identify the root cause.

How do I set breakpoints and inspect local variables in Python?

You can set breakpoints and inspect local variables in Python using pdb for local step-through execution. This interactive debugging approach lets you pause execution and analyze the current state.

Can I attach a debugger to a Python subprocess to resolve concurrency issues?

Yes, you can attach a debugger to Python subprocesses using debugpy. This facilitates remote inspection and helps developers inspect call stacks and mutate state to resolve complex concurrency issues.

Does this debugging approach work with the Python standard library out of the box?

Local step-through debugging works with the standard pdb module, while remote attachment requires installing the debugpy dependency to enable DAP-compliant inspection for long-running processes.

When should I use remote-pdb instead of standard pdb for debugging?

You should use remote debugging capabilities when attaching to headless services or long-running processes that cannot be paused locally, whereas standard pdb is sufficient for local step-through execution.