What problem does it solve?
ix-debug helps you pinpoint where a failure most likely originates in an execution path and identify a small set of actionable root-cause candidates with minimal source reading.
Core Features & Use Cases
- Execution-path root-cause analysis: Locates likely entry points from a symptom and explains roles, callers/callees, and failure positioning with graph queries.
- Targeted tracing with adaptive depth: Traces downstream from the entry point to narrow the 1–3 most suspicious nodes, and optionally checks callers when upstream invocation is likely.
- Minimal-code reading with guardrails: Reads at most two candidate functions for confirmation, preserving performance and token efficiency.
Use Case: You have an error log for a failing function or behavior in a codebase; ix-debug narrows the likely faulty boundary/orchestrator/utility contract and outputs 1–3 candidates with evidence.
Quick Start
Ask for root-cause analysis by running: ix-debug "<error message or symptom description>".