Skip to content
Merged
Changes from 3 commits
Commits
Show all changes
21 commits
Select commit Hold shift + click to select a range
e9e8cff
Add troubleshooting with console capture
alexkgold Feb 13, 2026
36ad8d2
Update apps/kilocode-docs/pages/getting-started/troubleshooting.md
alexkgold Feb 13, 2026
3d134dc
Update apps/kilocode-docs/pages/getting-started/troubleshooting.md
alexkgold Feb 13, 2026
631be09
Create troubleshooting section
alexkgold Feb 16, 2026
4169383
Merge branch 'docs/troubleshooting' of https://github.com/kilo-org/ki…
alexkgold Feb 16, 2026
d3fce69
Update apps/kilocode-docs/pages/troubleshooting/troubleshooting-exten…
alexkgold Feb 16, 2026
cbf96af
Update apps/kilocode-docs/pages/troubleshooting/troubleshooting-exten…
alexkgold Feb 16, 2026
27416f0
Update apps/kilocode-docs/pages/troubleshooting/troubleshooting-exten…
alexkgold Feb 16, 2026
e59ab2f
Update apps/kilocode-docs/AGENTS.md
alexkgold Feb 16, 2026
ec68a59
Apply suggestion from @alexkgold
alexkgold Feb 16, 2026
812a0a2
Apply suggestion from @alexkgold
alexkgold Feb 16, 2026
2178cf0
Update apps/kilocode-docs/pages/troubleshooting/index.md
alexkgold Feb 16, 2026
4dceb22
Move troubleshooting under help nav
alexkgold Feb 16, 2026
6cf499b
Update apps/kilocode-docs/package.json
alexkgold Feb 17, 2026
02c1b1a
Clean up troubleshooting rom top-level nav
alexkgold Feb 17, 2026
ba66108
Update apps/kilocode-docs/AGENTS.md
alexkgold Feb 17, 2026
ea01e16
Update apps/kilocode-docs/pages/getting-started/troubleshooting/troub…
alexkgold Feb 17, 2026
3aacc6e
Update apps/kilocode-docs/pages/getting-started/troubleshooting/index.md
alexkgold Feb 17, 2026
6c8c117
Merge branch 'main' into docs/troubleshooting
alexkgold Feb 17, 2026
17f2437
Apply suggestion from @alexkgold
alexkgold Feb 17, 2026
8fa46cd
Apply suggestion from @alexkgold
alexkgold Feb 17, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
58 changes: 58 additions & 0 deletions apps/kilocode-docs/pages/getting-started/troubleshooting.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,58 @@
---
title: "Troubleshooting Kilo Code"
description: "How to capture console logs and report issues with Kilo Code"
---

# Troubleshooting Kilo Code

When you encounter an issue with Kilo Code, console logs provide valuable debugging information that helps us identify and fix problems. This guide walks you through capturing those logs in your IDE.

## Opening Developer Tools

{% tabs %}
{% tab label="VS Code" %}

1. **Open the Command Palette**: Press `Ctrl+Shift+P` (Windows/Linux) or `Cmd+Shift+P` (Mac)
2. **Search for Developer Tools**: Type `Developer: Open Webview Developer Tools` and select it
3. The Developer Tools panel will open, showing the Console tab

{% /tab %}
{% tab label="JetBrains" %}

### Enable JCEF Debugging

1. Open your JetBrains IDE and go to **Help → Find Action** (or press `Cmd+Shift+A` / `Ctrl+Shift+A`)
2. Type `Registry` and open it
3. Search for `jcef` and configure these settings:
- `ide.browser.jcef.debug.port` → set to `9222`
- `ide.browser.jcef.contextMenu.devTools.enabled` → check the box
4. **Restart your IDE** after making these changes

### Connect Chrome DevTools

1. Make sure the **Kilo Code panel is open** in your IDE (the debug target won't appear unless the webview is active)
2. Open Chrome (or any Chromium-based browser like Edge or Arc)
3. Navigate to `http://localhost:9222/json` to see the list of inspectable targets
4. Find the entry with `"title": "Kilo Code"` and open the `devtoolsFrontendUrl` link
5. Chrome DevTools will open connected to the Kilo webview—click the **Console** tab

{% /tab %}
{% /tabs %}

## Capturing the Error

Once you have the Developer Tools console open:

1. **Clear previous logs**: Click the "Clear Console" button (🚫 icon at the top of the Console panel) to remove old messages
2. **Reproduce the issue**: Perform the action that was causing problems
3. **Check for errors**: Look at the Console tab for error messages (usually shown in red). If you suspect connection issues, also check the **Network** tab
4. **Copy the logs**: Right-click in the console and select "Save as..." or copy the relevant error messages

## Contact Support

If you're unable to resolve the issue, please send your console logs and a description of the problem to **[hi@kilocode.ai](mailto:hi@kilocode.ai)**. Include:

- The error messages from the console
- Steps to reproduce the issue
- Screenshots or screen recordings of the issue
- Your IDE and Kilo Code version
Loading