Skip to content

docs: add WSL disconnect diagnostics to troubleshooting guide - #14656

Merged
alexkgold merged 2 commits into
mainfrom
docs/wsl-disconnect-diagnostics
Sep 29, 2026
Merged

alexkgold merged 2 commits into
mainfrom
docs/wsl-disconnect-diagnostics

Conversation

@kilo-code-bot

@kilo-code-bot kilo-code-bot Bot commented Sep 29, 2026

Copy link
Copy Markdown
Contributor

What

Adds a "Diagnosing WSL disconnects" section to the existing Extension Troubleshooting page, based on this gist: https://gist.github.com/kirillk/1a50147ef0f39dc8948f9009d982ace3

Why

Users running Kilo Code with VS Code on WSL hit disconnects that are hard to diagnose after the fact — restarting WSL or rebooting wipes the evidence. This documents a single copy-paste command that captures a diagnostic bundle (kernel OOM events, WSL VM uptime, memory stats, VS Code remote server logs, and Kilo logs) to C:\Users\Public\kilo-diag.tgz before restarting, plus a request for the number of parallel Agent Manager sessions/worktrees.

Where

Integrated into the existing extension troubleshooting page (alongside the console-log capture and SQLite reset sections) rather than a new page, matching the docs' frontmatter, heading, numbered-step, and code-block conventions.

Verified with the kilo-docs vitest suite (4 files, 22 tests passing).

Built for Alex Gold by Kilo for Slack

@vercel

vercel Bot commented Sep 29, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
docs (docs-staging) Ready Ready Preview Sep 29, 2026 12:36pm UTC

Request Review

@kilo-code-bot

kilo-code-bot Bot commented Sep 29, 2026 •

Copy link
Copy Markdown
Contributor Author

Code Review Summary

Status: No Issues Found | Recommendation: Merge

Files Reviewed (1 file)
  • packages/kilo-docs/pages/getting-started/troubleshooting/troubleshooting-extension.md
Previous Review Summary (commit 69a6a4d)

Current summary above is authoritative. Previous snapshots are kept for context only.

Previous review (commit 69a6a4d)

Status: 1 Issue Found | Recommendation: Address before merge

Overview

Severity Count
CRITICAL 0
WARNING 0
SUGGESTION 1
Issue Details (click to expand)

SUGGESTION

File Line Issue
packages/kilo-docs/pages/getting-started/troubleshooting/troubleshooting-extension.md 98 New diagnostic flow asks users to send the log bundle without the secret-scrubbing caution used elsewhere on the page
Files Reviewed (1 file)
  • packages/kilo-docs/pages/getting-started/troubleshooting/troubleshooting-extension.md - 1 suggestion

The added section is otherwise accurate: the ~/.local/share/kilo/log path matches the CLI, the shell chain tolerates an empty OOM grep result, and the numbered-list/code-block indentation renders correctly.

Fix these issues in Kilo Cloud


Reviewed by deepseek-v4.1-flash · Input: 0 · Output: 0 · Cached: 0

Review guidance: REVIEW.md from base branch main

@alexkgold
alexkgold merged commit 88681ca into main Sep 29, 2026
29 checks passed
@alexkgold
alexkgold deleted the docs/wsl-disconnect-diagnostics branch September 29, 2026 12:40

This branch was successfully deployed

1 active deployment
docs-staging – docs — 2c819ec7 Deployed Sep 29, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant