windsurf-install-auth

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

⭐939stars🔀114forks📁View on GitHub🕐Updated Jan 11, 2026⬇️1downloads

When & Why to Use This Skill

The Windsurf Install & Auth skill automates the essential setup and configuration process for the Windsurf SDK and CLI. It simplifies developer onboarding by handling package installation for Node.js and Python, managing API authentication via environment variables, and verifying connectivity, ensuring a production-ready integration environment in seconds.

Use Cases

  • New Project Initialization: Rapidly install the Windsurf SDK and configure the necessary environment settings when starting a new integration project.
  • Secure Credential Management: Automate the creation of .env files and the configuration of WINDSURF_API_KEY to ensure secure and standardized authentication.
  • Cross-Language Environment Setup: Seamlessly switch between Node.js and Python environments with automated package management (npm/pip) tailored to the project's requirements.
  • Troubleshooting Connectivity: Utilize built-in error handling and verification steps to diagnose and resolve API key or network-related issues during the setup phase.
namewindsurf-install-auth
description|
allowed-toolsRead, Write, Edit, Bash(npm:*), Bash(pip:*), Grep
version1.0.0
licenseMIT
authorJeremy Longshore <jeremy@intentsolutions.io>

Windsurf Install & Auth

Overview

Set up Windsurf SDK/CLI and configure authentication credentials.

Prerequisites

  • Node.js 18+ or Python 3.10+
  • Package manager (npm, pnpm, or pip)
  • Windsurf account with API access
  • API key from Windsurf dashboard

Instructions

Step 1: Install SDK

# Node.js
npm install @windsurf/sdk

# Python
pip install windsurf

Step 2: Configure Authentication

# Set environment variable
export WINDSURF_API_KEY="your-api-key"

# Or create .env file
echo 'WINDSURF_API_KEY=your-api-key' >> .env

Step 3: Verify Connection

// Test connection code here

Output

  • Installed SDK package in node_modules or site-packages
  • Environment variable or .env file with API key
  • Successful connection verification output

Error Handling

Error Cause Solution
Invalid API Key Incorrect or expired key Verify key in Windsurf dashboard
Rate Limited Exceeded quota Check quota at https://docs.windsurf.com
Network Error Firewall blocking Ensure outbound HTTPS allowed
Module Not Found Installation failed Run npm install or pip install again

Examples

TypeScript Setup

import { WindsurfClient } from '@windsurf/sdk';

const client = new WindsurfClient({
  apiKey: process.env.WINDSURF_API_KEY,
});

Python Setup

from windsurf import WindsurfClient

client = WindsurfClient(
    api_key=os.environ.get('WINDSURF_API_KEY')
)

Resources

Next Steps

After successful auth, proceed to windsurf-hello-world for your first API call.