flight-profiler-stack

Inspect stack frames of the current running process. Essential for diagnosing hangs, deadlocks, and understanding what the process is doing right now. This is a non-streaming command — it captures a snapshot and returns immediately.

Prerequisites: Read the flight-profiler-attach skill first for platform requirements, installation, permissions, and connection details.

When to Use

• The process appears to hang or is unresponsive — see what each thread is blocked on
• You suspect a deadlock between threads
• You need to identify which thread holds the GIL
• You want to inspect async coroutine/task stacks to find stuck asyncio tasks
• You need native C-level frames (Linux only) for debugging C extension issues or GIL contention
• You want to locate the business code file paths and module names in the target process — stack frames reveal the exact files being executed, which helps determine the correct module, watch, and trace command arguments

Usage