Capturing Console Logs

Providing console logs helps us pinpoint exactly what's going wrong with your installation, network, or MCP setup. This guide walks you through capturing those logs in your IDE.

Opening Developer Tools

  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

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

SQLite database is malformed

If every prompt fails with SQLiteError: database disk image is malformed, Kilo Code's local SQLite database may be corrupted. This database stores local Kilo state such as sessions and history.

Find the database

The database location depends on where Kilo Code is running:

EnvironmentDatabase path
Windows%LOCALAPPDATA%\kilo\kilo.db
macOS~/Library/Application Support/kilo/kilo.db
Linux~/.local/share/kilo/kilo.db
VS Code Remote SSH~/.local/share/kilo/kilo.db on the remote machine
⚠️Warning

When using VS Code Remote SSH, check the remote Linux machine, not your local Windows or macOS computer.

Reset the database

Close VS Code or stop the Kilo backend first. On Linux or Remote SSH, run:

pkill -f "kilo serve"
mkdir -p ~/.local/share/kilo
mv ~/.local/share/kilo/kilo.db ~/.local/share/kilo/kilo.db.bak
mv ~/.local/share/kilo/kilo.db-wal ~/.local/share/kilo/kilo.db-wal.bak 2>/dev/null
mv ~/.local/share/kilo/kilo.db-shm ~/.local/share/kilo/kilo.db-shm.bak 2>/dev/null

Then reload VS Code or reconnect Remote SSH. Kilo Code recreates the database the next time it starts.

On Windows or macOS, rename the database file and any kilo.db-wal or kilo.db-shm files in the same folder, then restart the IDE.

⚠️Warning

Renaming this database resets local Kilo Code sessions and history for that machine. Keep the .bak files if you need to share them with support or attempt recovery later.

Fully reset local Kilo data

If resetting the database does not fix the issue, you can fully reset Kilo Code's local data. This also removes local configuration and cache files, so use it only after trying the database reset above.

On Linux or VS Code Remote SSH, run this on the machine where Kilo Code is running:

pkill -f "kilo serve"
mv ~/.local/share/kilo ~/.local/share/kilo.bak 2>/dev/null
mv ~/.config/kilo ~/.config/kilo.bak 2>/dev/null
mv ~/.cache/kilo ~/.cache/kilo.bak 2>/dev/null

Then reload VS Code or reconnect Remote SSH. Kilo Code recreates these directories the next time it starts.

⚠️Warning

This resets local sessions, history, settings, and cached data. Prefer renaming the directories instead of deleting them so you can recover files. Remove secrets such as API keys or tokens before sharing any backup with support.

Contact Support

If you're unable to resolve the issue, please inspect the console logs, remove any secrets, and send the logs to hi@kilocode.ai along with the following:

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