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, BIGGI's local SQLite database may be corrupted. This database stores local BIGGI state such as sessions and history.

Find the database

The database location depends on where BIGGI is running:

EnvironmentDatabase path
Windows%LOCALAPPDATA%\biggi\biggi.db
macOS~/Library/Application Support/biggi/biggi.db
Linux~/.local/share/biggi/biggi.db
VS Code Remote SSH~/.local/share/biggi/biggi.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 BIGGI backend first. On Linux or Remote SSH, run:

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

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

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

⚠️Warning

Renaming this database resets local BIGGI 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 BIGGI data

If resetting the database does not fix the issue, you can fully reset BIGGI'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 BIGGI is running:

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

Then reload VS Code or reconnect Remote SSH. BIGGI 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@biggi.dev 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 BIGGI version