Codex debug-lldb for Local Application Hang Triage
Compare repeated thread snapshots of a local test process to narrow down UI freezes and stalls. Correlate stable stack frames with the action that triggered the problem.
中文Install in Codex
Codex, a local test process you can debug, and platform tools such as LLDB on macOS or GDB on Linux.
- Copy the pinned `templates/skills/debug-lldb/` directory into the project's `.agents/skills/debug-lldb/`. Keep the stack collection script and triage reference.
- Open the project in Codex, invoke `$debug-lldb`, and specify the local process and time window.
Example task
Start a practice desktop app where a simulated slow file read blocks the UI. Ask for three thread snapshots and a comparison of the UI thread's wait frames.What to check
Expect time-stamped samples, the method involved if the wait is consistent, and one proposed check to narrow the cause.
Original SKILL.md on GitHub · Updated
Frequently asked question
Why collect more than one snapshot?
A sequence shows whether threads stay in the same frames or continue making progress.