windsurf-upgrade-migration

# Windsurf Upgrade & Migration ## Current State !`windsurf --version 2>/dev/null || echo 'Not installed'` !`code --version 2>/dev/null | head -1 || echo 'VS Code not installed'` ## Overview Guide for upgrading Windsurf to new versions and migrating from VS Code or Cursor. Covers settings transfer, extension compatibility, and Windsurf-specific configuration that doesn't exist in other editors. ## Prerequisites - Current editor installation accessible - Git for version controlling config files - Backup of existing settings ## Instructions ### Step 1: Check Current Windsurf Version ```bash # Current version windsurf --version # Check for updates # Windsurf auto-updates by default # Manual: Help > Check for Updates (or download from windsurf.com) ``` ### Step 2: Migrate from VS Code Windsurf is VS Code-based and supports most VS Code settings and extensions: ```bash # Windsurf imports VS Code settings on first launch # For manual migration: # 1. Export VS Code extensions list code --list-extensions > vscode-extensions.txt # 2. Install in Windsurf cat vscode-extensions.txt | xargs -L1 windsurf --install-extension # 3. Copy settings # macOS: cp ~/Library/Application\ Support/Code/User/settings.json \ ~/Library/Application\ Support/Windsurf/User/settings.json # Linux: cp ~/.config/Code/User/settings.json \ ~/.config/Windsurf/User/settings.json ``` **Key difference:** Remove or disable GitHub Copilot -- it conflicts with Windsurf's Supercomplete. ### Step 3: Mi...