# Windsurf — AI IDE with Cascade Agentic Flows

> AI-powered IDE by Codeium with Cascade multi-step agentic editing. Free tier includes Claude and GPT-4 access. VS Code-based with flows for complex refactoring tasks. 6,000+ stars.

## Install

Save the content below to `.claude/skills/` or append to your `CLAUDE.md`:

## Quick Use

1. Download from [windsurf.com](https://windsurf.com) (macOS, Windows, Linux)
2. Open your project
3. Press `Cmd+L` for chat or `Cmd+I` for inline edit
4. Try Cascade: "Refactor the auth module to use JWT with refresh tokens"

Cascade plans the changes across multiple files, shows diffs, and applies them.

---

## Intro

Windsurf is an AI-powered IDE by Codeium featuring Cascade — a multi-step agentic editing system that plans and executes complex code changes across multiple files with 6,000+ GitHub stars. Built on VS Code, it includes free access to Claude and GPT-4 for chat, autocomplete, and agentic flows. Unlike simple inline completions, Cascade understands your entire codebase and can orchestrate multi-file refactoring, feature additions, and bug fixes autonomously. Best for developers who want an AI IDE with strong agentic capabilities at a lower price than Cursor. Works with: Claude, GPT-4, Codeium models. Setup time: under 3 minutes.

---

## Key Features

### Cascade Flows
Multi-step agentic editing that plans before acting:

```
You: "Add rate limiting to all API endpoints"

Cascade:
Step 1: Analyzing 12 API route files...
Step 2: Creating rate-limit middleware (middleware/rateLimit.ts)
Step 3: Applying middleware to all route handlers
Step 4: Adding rate limit config to .env
Step 5: Writing tests for rate limiting

[Show diffs] [Apply all] [Apply selectively]
```

### Supercomplete
Context-aware autocomplete that predicts multi-line edits:
- Understands your coding patterns
- Predicts next logical change
- Tab to accept, Esc to dismiss

### Chat with Codebase
```
"How does the payment processing work?"
"What tests cover the auth module?"
"Find all places where we handle errors"
```

### Command Mode
Quick actions without leaving the editor:
```
Cmd+I: "Add TypeScript types to this function"
Cmd+I: "Write a test for the selected code"
Cmd+I: "Explain this regex"
```

### Free Tier

| Feature | Free | Pro ($15/mo) |
|---------|------|-------------|
| Autocomplete | Unlimited | Unlimited |
| Chat | Limited | Unlimited |
| Cascade flows | 5/day | Unlimited |
| Claude/GPT-4 | Yes | Yes |

### VS Code Compatibility
- Full extension marketplace
- Settings sync from VS Code
- Existing keybindings work
- Themes and snippets transfer

### Key Stats
- 6,000+ GitHub stars
- By Codeium (AI code company)
- Cascade multi-step agentic flows
- Free Claude + GPT-4 access
- VS Code-based

### FAQ

**Q: What is Windsurf?**
A: An AI IDE by Codeium featuring Cascade — multi-step agentic editing that plans and executes complex changes across files, with free Claude and GPT-4 access.

**Q: Is Windsurf free?**
A: Free tier with limited Cascade flows. Pro is $15/mo for unlimited.

**Q: How does Windsurf compare to Cursor?**
A: Windsurf has stronger agentic flows (Cascade) and a cheaper Pro plan ($15 vs $20). Cursor has a more mature extension ecosystem and broader model selection.

---

## Source & Thanks

> Created by [Codeium](https://github.com/Exafunction). Licensed under proprietary.
>
> [windsurf](https://windsurf.com) — stars 6,000+

Thanks to Codeium for making agentic IDE editing accessible.

---

<!-- ZH -->

## 快速使用

1. 从 [windsurf.com](https://windsurf.com) 下载
2. 打开项目，按 `Cmd+L` 聊天或 `Cmd+I` 内联编辑
3. 试试 Cascade: "重构认证模块使用 JWT 刷新令牌"

---

## 简介

Windsurf 是 Codeium 推出的 AI IDE，GitHub 6,000+ stars。核心功能 Cascade 可跨多文件规划和执行复杂代码变更。免费层包含 Claude 和 GPT-4 访问。Pro $15/月。适合需要强 Agent 编辑能力且预算有限的开发者。

---

## 来源与感谢

> Created by [Codeium](https://github.com/Exafunction).
>
> [windsurf](https://windsurf.com) — stars 6,000+

---
Source: https://tokrepo.com/en/workflows/f2cfae6c-6321-496d-833d-5a5c77567712
Author: Skill Factory