Cursor and Windsurf Setup Guide

December 29, 2025 ยท View on GitHub

This guide provides detailed instructions for installing and using VT Code with Cursor and Windsurf editors.

Overview

VT Code is available for both Cursor and Windsurf through the Open VSX registry. Since both editors support VS Code extensions, the VT Code extension provides the same functionality as in VS Code.

Prerequisites

Before installing the VT Code extension in Cursor or Windsurf, you need to install the VT Code CLI:

# Install with Cargo (recommended)
cargo install vtcode

# Or with Homebrew
brew install vtcode

# Or with NPM

Verify the installation:

vtcode --version

Installation Methods

For Cursor:

  1. Open Cursor
  2. Go to Extensions panel (Ctrl+Shift+X or Cmd+Shift+X)
  3. Search for "vtcode-companion"
  4. Click Install

For Windsurf:

  1. Open Windsurf
  2. Go to Extensions panel
  3. Search for "vtcode-companion"
  4. Click Install

Method 2: VSIX File Installation

If the extension isn't available through the marketplace:

  1. Download the .vsix file from Open VSX
  2. In your editor's Extensions panel, click the "..." menu
  3. Select "Install from VSIX..."
  4. Choose the downloaded VSIX file

Method 3: CLI Installation (Cursor Only)

For Cursor, you can also install the extension via CLI:

# Replace with actual version
cursor --install-extension vtcode-companion-<version>.vsix

Configuration

After installation, the VT Code extension should work automatically if:

  1. The VT Code CLI is installed and in your system PATH
  2. Your workspace contains a vtcode.toml configuration file

To create a configuration file:

  1. Open Command Palette (Ctrl+Shift+P or Cmd+Shift+P)
  2. Run "VT Code: Open Configuration"
  3. Configure your AI providers and settings

Features Available

The VT Code extension provides the same features in Cursor and Windsurf as in VS Code:

  • Ask the Agent: Send questions to the VT Code AI assistant
  • Ask About Selection: Get explanations for selected code
  • Quick Actions Panel: Access common VT Code commands
  • Terminal Integration: Launch VT Code chat directly in the editor
  • Configuration Management: Manage vtcode.toml settings
  • Semantic Code Intelligence: AST-based code understanding

Troubleshooting

Extension Not Working

  1. Verify VT Code CLI is installed:

    vtcode --version

  2. Ensure VT Code is in your PATH:

    which vtcode

  3. Restart your editor after installing the extension

  4. Check that your workspace contains a vtcode.toml configuration file

CLI Path Issues

If the extension can't find the VT Code CLI:

  • In Cursor/Windsurf settings, look for vtcode.commandPath setting
  • Set the full path to your VT Code executable if it's installed in a non-standard location

Configuration Issues

  1. Make sure your vtcode.toml file is in the root of your workspace
  2. Verify your API keys are properly configured in the configuration file
  3. Restart the editor after making configuration changes

Support

If you encounter issues:

  1. Check the main troubleshooting guide
  2. Join our community Discord
  3. Open an issue on our GitHub repository
  4. Verify that your Cursor or Windsurf version supports the VS Code extension format

Updating the Extension

The extension will typically update automatically when new versions are published to Open VSX. You can also manually check for updates in your editor's Extensions panel.

Note: VT Code is designed to work with VS Code-compatible editors through the Open VSX registry. For the best experience, ensure you have the latest version of both the extension and the VT Code CLI.