windsurf-install-auth

# Windsurf Install & Auth ## Overview Windsurf is an AI-powered code editor by Codeium (now Cognition AI), built on VS Code. It features Cascade (agentic AI assistant), Supercomplete (intent-aware autocomplete), and deep codebase indexing. Authentication is handled through Codeium accounts, not raw API keys. ## Prerequisites - macOS, Windows, or Linux (64-bit) - 8GB RAM minimum (16GB recommended for large codebases) - Internet connection for AI features ## Instructions ### Step 1: Install Windsurf **macOS:** ```bash brew install --cask windsurf ``` **Linux (Debian/Ubuntu):** ```bash curl -fsSL https://windsurf.com/install.sh | bash # Or download .deb from https://windsurf.com/download ``` **Windows:** Download installer from https://windsurf.com/download ### Step 2: Authenticate with Codeium On first launch, Windsurf prompts for Codeium authentication: 1. Click "Sign In" in the welcome tab or Windsurf widget (bottom-right status bar) 2. Browser opens to Codeium auth page 3. Sign in with Google, GitHub, or email 4. Authorization token is stored locally at `~/.codeium/` **Verify authentication:** - Check the Windsurf widget in the status bar -- it should show a checkmark - Open Cascade (Cmd/Ctrl+L) and send a test message ### Step 3: Configure for Enterprise / Team For team deployments with centralized auth: ```json // Settings > Windsurf Settings (or ~/.codeium/config.json) { "codeium.apiServer": "https://codeium.yourcompany.com", "codeium.portal.url": "https...