python-debugpy

Debug Python code locally, remotely, and post-mortem using pdb and debugpy.

3|Updated Apr 21, 2026
One-click install
npx skills add https://github.com/DarkArty07/Aether-Agents --skill python-debugpy-darkarty07
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: python-debugpy
Source: https://github.com/DarkArty07/Aether-Agents/tree/main/home/skills/software-development/python-debugpy
Command: npx skills add https://github.com/DarkArty07/Aether-Agents --skill python-debugpy-darkarty07

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the frustration of debugging Python code across diverse scenarios—from simple local script issues to hard-to-reproduce bugs in long-running services, subprocesses, and async handlers—where print statements and basic logging fail to provide enough context to identify root causes.

Core Features & Use Cases

  • Local Interactive Debugging: Use built-in breakpoint and pdb for quick, no-setup debugging of local scripts, functions, and pytest tests, with full access to local variables and call stacks.
  • Remote & Headless Debugging: Use debugpy to attach to running long-lived processes (such as Hermes gateways, daemons, and subprocesses) without restarting them, or launch processes under a debugger from the start.
  • Post-Mortem & Edge Case Debugging: Inspect program state immediately after unhandled exceptions, and debug multithreaded, asyncio, and multiprocessing code with tailored workarounds for common pitfalls.
  • Use Case Example: Debug an intermittently crashing Hermes gateway by attaching debugpy to the running process to inspect its state at the crash site, without disrupting active users or restarting the service.

Quick Start

Use the python-debugpy skill to debug a failing Python test by dropping into an interactive pdb REPL at the point of failure to inspect local variables and step through code to identify the root cause.

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 service without restarting it?

You can attach debugpy to a running long-lived Python process, such as a Hermes gateway or daemon, to inspect its state at a crash site. This remote debugging approach allows you to debug without restarting the service or disrupting active users.

How does post-mortem debugging work for unhandled Python exceptions?

Post-mortem debugging allows you to inspect program state immediately after an unhandled exception occurs. You can use pdb to drop into an interactive REPL at the exact point of failure to examine local variables and call stacks to identify the root cause.

Can I debug pytest tests using pdb breakpoints?

Yes, you can debug failing pytest tests by dropping into an interactive pdb REPL at the point of failure. This local interactive debugging provides full access to local variables and call stacks to step through code and identify the root cause.

What is the best way to debug async and multithreaded Python code?

Debugging async and multithreaded Python code requires tailored workarounds for common pitfalls. You can use pdb and debugpy to set breakpoints, step through execution, and inspect call stacks in asyncio handlers and multiprocessing contexts.

Does debugpy support the DAP protocol for remote headless debugging?

Yes, debugpy supports the DAP protocol for remote headless debugging of Python code. You can attach it to running processes or launch processes under a debugger from the start to inspect call stacks and local variables.

When should I use remote-pdb instead of print statements for Python debugging?

Use remote-pdb when print statements and basic logging fail to provide enough context to identify root causes across diverse scenarios. It is ideal for hard-to-reproduce bugs in subprocesses, async handlers, and long-running services.