Skip to main content

Debug the right process

Renderer, host adapter, and native server are different processes. Inspect the correct one before drawing a conclusion.

SurfaceWhat to inspect
VS Code webviewDeveloper: Open Webview Developer Tools / supported renderer inspector
VS Code extension hostHeapLens Output channel, extension-host debugger
IntelliJIDE logs and supported JCEF inspection/development tools
StandaloneBrowser developer tools plus launcher/host stderr
Native serverLocal stderr, process status, RPC responses/notifications

Developer tools vary by host/version. A browser's normal console is not the native analysis console.

Small reproduction​

Use a safe small dump, record version/backend/platform and the failing action, then check console errors, local asset loading, and the request/notification boundary. Keep the original dump immutable.

Charts use packaged D3, not a CDN. Empty views can come from missing completion data, stale session routing, an unavailable renderer asset, or an actual backend failure. Confirm evidence rather than assuming one cause.

Do not log entire heap analysis objects or API credentials. Names, raw previews, queries, source, file paths, private session URLs, and provider errors can be sensitive. Scrub screenshots/logs before support sharing; local diagnostics are not automatically safe public attachments.

Maintainer checks​

Use read-only mock/native fixtures for consent and request-body tests. Separate first-turn/follow-up AI context and host policies. Test late messages from a retired server, Cancel/Retry, two independent dumps, theme switching, and bounded results.

Never post a real user's full dump to reproduce a UI issue. See telemetry for bounded diagnostic data and support.