About

Imported from jeremylongshore/tons-of-skills-marketplace (plugins/saas-packs/windsurf-pack/skills/windsurf-install-auth/SKILL.md). Install upstream with npx skills add jeremylongshore/tons-of-skills-marketplace --skill windsurf-install-auth. Copyright stays with the author (MIT).

Windsurf Install & Auth

Name: windsurf-install-auth
Author: jeremylongshore

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:

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

Step 2: Authenticate with Codeium

On first launch, Windsurf prompts for Codeium authentication:

Click "Sign In" in the welcome tab or Windsurf widget (bottom-right status bar)
Browser opens to Codeium auth page
Sign in with Google, GitHub, or email
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:

// 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"

Step 4: Verify AI Features Are Working

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)

Step 5: Select Your AI Model

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 Handling

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

Examples

Migrate Settings from VS Code

# Windsurf inherits VS Code extensions and settings
# Import on first launch or manually:
# Windsurf > Command Palette > "Import VS Code Settings"

Verify Installation

# Check Windsurf CLI is available
windsurf --version

# Open project in Windsurf from terminal
windsurf /path/to/project

Resources

Next Steps

After authentication, proceed to windsurf-hello-world for your first Cascade interaction.

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/jeremylongshore-tons-of-skills-marketplace-windsurf-inst-b73d7d/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

jeremylongshore-tons-of-skills-marketplace-windsurf-inst-b73d7d.ocm.jsonjson

{
  "ocm": "1",
  "id": "jeremylongshore-tons-of-skills-marketplace-windsurf-inst-b73d7d",
  "kind": "skill",
  "name": "windsurf-install-auth",
  "description": "Install Windsurf IDE and configure Codeium authentication. Use when setting up Windsurf for the first time, logging in to Codeium, or configuring API keys for team/enterprise deployments. Trigger with phrases like \"install windsurf\", \"setup windsurf\", \"windsurf auth\", \"codeium login\", \"windsurf API key\".",
  "publisher": "jeremylongshore",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "coding"
    ],
    "tags": [
      "skill-md",
      "saas",
      "windsurf",
      "codeium",
      "authentication",
      "ide-setup",
      "skills-sh"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Install Windsurf IDE and configure Codeium authentication. Use when setting up Windsurf for the first time, logging in to Codeium, or configuring API keys for team/enterprise deployments. Trigger with phrases like \"install windsurf\", \"setup windsurf\", \"windsurf auth\", \"codeium login\", \"windsurf API key\"."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "skills.sh",
      "repository": "https://github.com/jeremylongshore/tons-of-skills-marketplace",
      "path": "plugins/saas-packs/windsurf-pack/skills/windsurf-install-auth/SKILL.md",
      "ref": "HEAD",
      "url": "https://github.com/jeremylongshore/tons-of-skills-marketplace/blob/HEAD/plugins/saas-packs/windsurf-pack/skills/windsurf-install-auth/SKILL.md",
      "key": "jeremylongshore/tons-of-skills-marketplace/plugins/saas-packs/windsurf-pack/skills/windsurf-install-auth/SKILL.md"
    },
    "compatibility": "Designed for Claude Code",
    "allowed_tools": [
      "Read,",
      "Write,",
      "Edit,",
      "Bash(npm:*),",
      "Bash(brew:*),",
      "Bash(curl:*),",
      "Grep"
    ],
    "license": "MIT"
  },
  "instructions": "# Windsurf Install & Auth\n\n## Overview\n\nWindsurf 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.\n\n## Prerequisites\n\n- macOS, Windows, or Linux (64-bit)\n- 8GB RAM minimum (16GB recommended for large codebases)\n- Internet connection for AI features\n\n## Instructions\n\n### Step 1: Install Windsurf\n\n**macOS:**\n\n```bash\nbrew install --cask windsurf\n```\n\n**Linux (Debian/Ubuntu):**\n\n```bash\n",
  "cost": {
    "context_tokens": 946
  }
}

Fetch it by URL: GET /api/v1/registry/jeremylongshore-tons-of-skills-marketplace-windsurf-inst-b73d7d/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.