DebugAIdocs

Read a result

Know what each part of the results panel means, how far to trust a fix, and what to do when an answer comes back empty.

The panel answers two things: what broke, and what to change. Every fix also says how much of it was checked, so you can tell a tested answer from a confident guess.

The parts of the panel

The answer opens in a DebugAI tab beside your code, headed DebugAI Results.

  • Root Cause is the explanation, in plain language.
  • A row of badges says where the answer came from (see Badges).
  • Ranked Fixes lists up to three fixes, the most likely first.
  • Was this helpful? sends DebugAI your verdict (see Tell DebugAI how it went).
  • The last line counts what your plan has left: 9 AI debugs remaining today, or on a monthly plan 120 of 1000 debugs used this month.
  • Session History, on the left, lists your recent analyses.

Each fix

A fix card shows:

  • its rank and title;
  • where it applies, as plain text such as cart.py:11 (not a link), and in settings.py when the fix belongs in a different file from the one in the error;
  • a confidence figure with a bar: green at 80% and above, amber from 60%, red below 60%;
  • one of three verification labels;
  • why this fix, then the code;
  • Preview & Apply Fix and Copy. See Apply and undo a fix.

No fixes available. means the answer came back with no fix to offer.

The three labels

Hover a label to see the reason DebugAI gives for it.

LabelMeans
✓ VerifiedA mechanical check ran on this fix and passed. The tooltip names the check, or says Mechanical check passed.
✗ Failed checkDebugAI disproved its own fix before showing it to you, and capped its confidence. The tooltip says what failed.
Not verifiedNothing checked this fix. The tooltip says Not checked mechanically. The % is the model's own estimate. and gives the reason when there is one.

A high percentage on a Not verified fix is the model's opinion of itself. Read the diff before you apply it. More in Verification.

Badges

The first badge is about this error's history in your project, when it has one:

BadgeMeans
Fixed before · verifiedA live session watched this error stop after the fix was applied.
Fixed beforeA fix for this error was applied and accepted here before. Not observed to work.
A previous fix didn't holdA fix was applied for this error before and the error came back. The analysis below has been told not to repeat it.
Seen beforeThis exact error has occurred in this project before.

Then, when they apply:

  • Cached: the answer came from DebugAI's store of recent answers to the same request.
  • 12 files (or another number): the answer drew on that many files from your project index. No badge means no indexed file was used.
  • high confidence, medium confidence or low confidence: the analysis's overall confidence.
  • A framework name, such as fastapi or nextjs, when one was detected.
  • Fast or Full: which model answered. Fast means a Haiku model. Full means any other: Sonnet, which Pro and Team get on hard errors, or the fallback model DebugAI uses when Claude is unavailable.
  • The name of a known error pattern, when the error matched one.

How memory works, and how a fix earns "verified": Error memory.

Session History

The last 20 analyses stay in the panel's sidebar, newest first, and survive a restart. Click one to open it again. The footer shows your extension version.

Tell DebugAI how it went

Thumbs up records the answer as helpful. Thumbs down asks What went wrong? (helps us improve) and offers Wrong fix, Wrong file, Off-target error, Too generic and Other. Other opens the Feedback tab on your dashboard, where you can say more.

Applying a fix records it as helpful by itself, and the thumbs lock for that answer. Copying a fix is recorded too.

When the analysis fails

The reason comes as a notification. If a results panel is already open, a card with the same sentence takes the place of the old answer. Its second button is always Analyze error from terminal.

HeadingWhat happenedButton
The engine timed outNo answer within 110 seconds.Try again
Cannot reach DebugAINo connection to DebugAI's servers, or a firewall in the way.Try again
Your key was rejectedThe key is invalid or expired.Update key
Daily limit reachedThe free plan's daily debugs are used. They reset at 00:00 UTC.See plans
Monthly ceiling reachedA paid account passed its monthly usage ceiling.Open dashboard
Slow down for a momentToo many requests in a short window. The message says how long to wait.Try again
The server failedDebugAI's side failed. The message is the server's own explanation when it sent one.Try again
Analysis failedAnything else. The message carries the HTTP status or error code, which is what to quote in a bug report.Try again

Full texts and fixes for each: Answers and limits.

Insufficient context

Sometimes the only fix is titled Insufficient context for specific fix, at 20%. DebugAI could not see enough code to name a cause, and the description says which of four things went wrong:

DebugAI saw the error text but had no project attached, so there was nothing to read your code from. Open your project folder in VS Code, run 'DebugAI: Index Entire Workspace', then try again.

No folder is open. Open your project folder, index it, and run the debug again.

DebugAI read the stack trace and found <files>, but none of it is in your project index yet, so it could not see the code. Run 'DebugAI: Index Entire Workspace' and try again. Indexing runs once and covers every later error in this project.

The files are real but not indexed yet. Index your project and run it again.

The error names no file, so DebugAI had nothing to look up. Paste the full stack trace rather than the last line. If this error genuinely carries no frames, run 'DebugAI: Index Entire Workspace' so DebugAI can search your project for it instead.

You sent the last line of an error. Send the whole trace. When an editor file was sent along and it does not look like the source, the same advice reads:

The error names no file, and the open file does not appear to be where it came from. Paste the full stack trace rather than the last line — the frames are what let DebugAI find the source.
DebugAI had your code and still could not narrow this to one fix. That usually means the cause is outside the files the trace names. Try the error again with more of the surrounding output, or open the file you suspect and run 'DebugAI: Analyze Error' there.

The index worked and the answer still was not specific. Send more of the output, or open the file you suspect and analyse from there.

Next

On this page