Install and configure Windsurf SDK/CLI authentication. Use when setting up a new Windsurf integration, configuring API keys, or initializing Windsurf in your project. Trigger with phrases like "install windsurf", "setup windsurf", "windsurf auth", "configure windsurf API key".
npxskills add jeremylongshore/claude-code-plugins-plus-skills--skill windsurf-install-authLoading…
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.
macOS:
brew install --cask windsurf
Linux (Debian/Ubuntu):
curl -fsSL https://windsurf.com/install.sh | bash
# Or download .deb from https://windsurf.com/download
Windows: Download installer from https://windsurf.com/download
On first launch, Windsurf prompts for Codeium authentication:
~/.codeium/Verify authentication:
For team deployments with centralized auth:
// Settings > Windsurf Settings (or ~/.codeium/config.json)
{
"codeium.apiServer": "https://codeium.yourcompany.com",
"codeium.portal.url": "https://portal.yourcompany.com",
"codeium.enterpriseMode": true
}
Enterprise API key (headless / CI environments):
# Set via environment variable for non-interactive use
export CODEIUM_API_KEY="your-enterprise-api-key"
1. Open any project folder in Windsurf
2. Type in a code file -- Supercomplete suggestions should appear
3. Press Cmd/Ctrl+L to open Cascade chat
4. Type "explain this project" -- Cascade should respond with codebase analysis
5. Check status bar widget shows model name (e.g., SWE-1, Claude, GPT)
Cascade supports multiple models. Configure via the model selector dropdown in the Cascade panel:
| Model | Plan Required | Best For |
|---|---|---|
| SWE-1 Lite | Free | Basic coding tasks |
| SWE-1 | Pro ($15/mo) | Complex multi-file edits |
| SWE-1.5 | Pro | Frontier-level performance |
| Claude Sonnet | Pro | Nuanced reasoning |
| GPT-4o | Pro | General-purpose coding |
| Gemini Pro | Pro | Large context tasks |
| Error | Cause | Solution |
|---|---|---|
| "Sign in required" | Auth token expired | Click Windsurf widget > Sign In |
| Cascade not responding | Not authenticated | Check status bar for auth status |
| No completions appearing | Supercomplete disabled | Click status bar widget > enable autocomplete |
| Enterprise auth fails | Wrong API server URL | Verify codeium.apiServer setting |
| "Indexing failed" | Workspace too large | Add .codeiumignore to exclude large dirs |
# Windsurf inherits VS Code extensions and settings
# Import on first launch or manually:
# Windsurf > Command Palette > "Import VS Code Settings"
# Check Windsurf CLI is available
windsurf --version
# Open project in Windsurf from terminal
windsurf /path/to/project
After authentication, proceed to windsurf-hello-world for your first Cascade interaction.
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Set up and use 1Password CLI (op). Use when installing the CLI, enabling desktop app integration, signing in (single or multi-account), or reading/injecting/running secrets via op.
CLI to manage emails via IMAP/SMTP. Use `himalaya` to list, read, write, reply, forward, search, and organize emails from the terminal. Supports multiple accounts and message composition with MML (MIME Meta Language).
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Set up and use 1Password CLI (op). Use when installing the CLI, enabling desktop app integration, signing in (single or multi-account), or reading/injecting/running secrets via op.
CLI to manage emails via IMAP/SMTP. Use `himalaya` to list, read, write, reply, forward, search, and organize emails from the terminal. Supports multiple accounts and message composition with MML (MIME Meta Language).