Skip to content

troubleshooting.md

Latest commit

 

History

History
96 lines (63 loc) · 3.09 KB

troubleshooting.md

File metadata and controls

96 lines (63 loc) · 3.09 KB

VT Code Troubleshooting Guide

This guide covers common issues and solutions when using VT Code with your IDE.

Prerequisites Not Found

Issue: VT Code extension can't find the VT Code CLI.

Solution:

  1. Ensure VT Code CLI is installed:

    # Install with Cargo (recommended)
cargo install vtcode

# Or with Homebrew
brew install vtcode

# Or with NPM

  2. Check that VT Code is in your PATH:

    vtcode --version

  3. If VT Code is installed in a custom location, update your IDE settings to point to the correct path:

    • VS Code: Set vtcode.commandPath in settings to the full path of the VT Code executable
    • Cursor/Windsurf: Look for similar extension settings to specify the VT Code executable path

Extension Not Working

Issue: VT Code commands are not responding or showing errors.

Solution:

  1. Restart your IDE after installing the extension
  2. Check that your workspace contains a vtcode.toml configuration file
  3. Verify the extension is enabled in your IDE
  4. Check the IDE's output panel for error messages

AI Provider Not Working

Issue: VT Code can't connect to AI providers (OpenAI, Anthropic, etc.).

Solution:

  1. Ensure you have valid API keys in your vtcode.toml configuration file
  2. Check that your API key has sufficient permissions
  3. Verify your internet connection
  4. Check if the AI provider has any service interruptions

Slow Performance

Issue: VT Code is taking a long time to respond or analyze code.

Solution:

  1. For large codebases, consider excluding large directories in your vtcode.toml
  2. Check that your system has sufficient memory and CPU resources
  3. Ensure your internet connection is stable if using cloud-based AI providers
  4. Consider switching to a faster AI model in your configuration

Configuration Issues

Issue: VT Code isn't using expected configuration settings.

Solution:

  1. Verify your vtcode.toml file is in the root of your workspace
  2. Check the syntax of your configuration file
  3. Restart your IDE after making configuration changes
  4. Use the "VT Code: Open Configuration" command to edit your config directly

VS Code-Compatible Editors

Issue: Using VT Code with Cursor, Windsurf, or other VS Code-compatible editors.

Solution: VT Code works with any VS Code-compatible editor through the Open VSX registry:

  1. Ensure the VT Code CLI is installed separately on your system
  2. Install the extension from the Open VSX registry or via VSIX file
  3. The extension behavior should be identical to VS Code
  4. Configuration settings may be located in different places depending on the editor

Need More Help?

If you're still experiencing issues:

  1. Check the main documentation
  2. Review the Cursor and Windsurf Setup Guide for editor-specific instructions
  3. Join our community Discord
  4. Open an issue on our GitHub repository
  5. Provide detailed information about your setup, the issue you're experiencing, and any error messages