Beginner10 min

Discover Windsurf, Codeium's AI-powered IDE built for flow state coding with Cascade and collaborative AI features.

Introduction to Windsurf

Windsurf is an AI-powered IDE from Codeium, designed around the concept of "flow state" coding. It combines agentic AI capabilities with a seamless editor experience.

What is Windsurf?

Windsurf is a VS Code-based editor that deeply integrates AI:

Cascade: Agentic AI assistant for complex tasks
Flows: Automated workflows and snippets
Supercomplete: Context-aware code completions
Multi-file editing: Coordinated changes
Free tier: Generous free usage included

The Windsurf Philosophy

Flow State Focus

Windsurf is designed to keep you in flow:

Terminal

Traditional AI Tools:
  Code → Stop → Ask AI → Copy → Paste → Resume

Windsurf Flow:
  Code continuously ←→ AI assists naturally

The AI integrates so smoothly that context switches are minimized.

Agentic by Design

Cascade isn't just chat—it's an agent:

Terminal

You: "Add user authentication to this app"

Cascade:
├── Analyzes current structure
├── Plans implementation
├── Creates auth provider
├── Adds login/signup pages
├── Updates routes
├── Integrates middleware
├── Runs and verifies
└── Reports completion

Key Features

Cascade

The intelligent AI assistant:

Terminal

┌─────────────────────────────────────────────────────────┐
│                      Cascade                             │
├─────────────────────────────────────────────────────────┤
│                                                         │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐     │
│  │   Chat      │  │   Write     │  │   Terminal  │     │
│  │   Mode      │  │   Mode      │  │   Mode      │     │
│  └─────────────┘  └─────────────┘  └─────────────┘     │
│                                                         │
│  • Deep context awareness                               │
│  • Multi-file operations                                │
│  • Command execution                                    │
│  • Web browsing capability                              │
│  • Iterative problem solving                            │
│                                                         │
└─────────────────────────────────────────────────────────┘

Supercomplete

Advanced code completions:

Terminal

// You type:
async function fetchUsers()

// Supercomplete suggests:
async function fetchUsers(): Promise<User[]> {
  const response = await fetch('/api/users', {
    headers: {
      'Authorization': `Bearer ${getToken()}`
    }
  })
  if (!response.ok) throw new Error('Failed to fetch users')
  return response.json()
}

Flows

Automated coding workflows:

Terminal

Flow: "Create React Component"
├── Generate component file
├── Generate test file
├── Generate styles
├── Update barrel exports
└── All with consistent naming

Multi-File Awareness

Context spans your entire project:

Terminal

You: "Rename the User model to Account"

Windsurf:
├── Updates prisma/schema.prisma
├── Updates types/user.ts → types/account.ts
├── Updates all imports
├── Updates all references
├── Updates API routes
└── Updates test files

Model Selection

Cascade supports multiple AI models:

Model	Best For	Availability
GPT-5.4	Complex reasoning, architecture	Pro tier
Claude 4.6 Sonnet	Balanced speed and quality	All tiers
Claude 4.6 Haiku	Fast completions	All tiers
Gemini 3.x	Multi-modal tasks	Pro tier

Switch models in Cascade:

Terminal

Cascade → Settings icon → Model Selection

Windsurf vs Other Editors

Feature	Windsurf	Cursor	VS Code + Copilot
Base Editor	VS Code fork	VS Code fork	VS Code
AI Agent	Cascade	Composer	Agent Mode
Free Tier	Yes	Trial only	Limited
Completions	Supercomplete	Tab	Copilot
Flows	Yes	No	No
Web Access	Yes	Yes	Yes
MCP Support	Limited	Yes	No

When to Choose Windsurf

Best for:

Developers who want agentic AI without paid tiers
Teams evaluating AI editors
Flow state enthusiasts
Multi-file operation needs

Consider alternatives for:

Maximum model flexibility (Cursor)
GitHub integration depth (Copilot)
Terminal-only workflow (Claude Code)

Architecture

Windsurf's architecture:

Terminal

┌─────────────────────────────────────────────────────────┐
│                    Windsurf IDE                         │
├─────────────────────────────────────────────────────────┤
│  ┌─────────────────────┐  ┌─────────────────────────┐   │
│  │   Editor Core       │  │    AI Engine            │   │
│  │   (VS Code base)    │  │    (Codeium)            │   │
│  │                     │  │                         │   │
│  │  - File editing     │  │  - Supercomplete        │   │
│  │  - Terminal         │  │  - Cascade agent        │   │
│  │  - Extensions       │  │  - Flows system         │   │
│  │  - Git integration  │  │  - Context engine       │   │
│  └─────────────────────┘  └─────────────────────────┘   │
│                                                         │
│  ┌─────────────────────────────────────────────────┐   │
│  │              Codeium Cloud Services               │   │
│  │  - AI models                                      │   │
│  │  - Code indexing                                  │   │
│  │  - Web search                                     │   │
│  └─────────────────────────────────────────────────┘   │
└─────────────────────────────────────────────────────────┘

Pricing

Free Tier

Unlimited Supercomplete
Limited Cascade credits
Basic Flows
Community support

Pro Tier

Unlimited Cascade
Advanced Flows
Priority support
Team features

Enterprise

Custom deployment
Security compliance
Admin controls
SSO integration

The Codeium Connection

Windsurf is built by Codeium:

Codeium: The AI engine (also available as VS Code extension)
Windsurf: The full IDE experience

If you've used Codeium before, Windsurf adds:

Cascade agentic assistant
Flows automation
Deeper editor integration
Enhanced multi-file capabilities

What You'll Learn

This module covers:

Setup: Installing and configuring Windsurf
Cascade: Mastering the AI assistant
Flows: Automating repetitive tasks

Summary

Windsurf is Codeium's AI-powered IDE
Cascade provides agentic AI capabilities
Supercomplete offers intelligent completions
Flows automate coding workflows
Free tier makes it accessible to everyone
Flow state design minimizes context switching

Next Steps

Let's get Windsurf installed and set up your development environment.

Mark this lesson as complete to track your progress