Intermediate

Learn Windsurf (Codeium): From Beginner to Confident User

Learn Windsurf for agentic AI coding with Cascade and deep codebase awareness. Whether you're starting from scratch or looking to go deeper, this guide gives you a clear path from first use to genuine mastery.

πŸ„
Windsurf (Codeium)
~1 week to learn

Learn AI properly, free or with a certificate

LearnWithZavi is our own site. The Udemy link is an affiliate link; we may earn a commission at no extra cost to you.

Worked prompts with sample output

Each sample output shows the shape of a useful answer. Your results will differ, so check facts, names and numbers before you rely on them.

Plan in Chat mode before writing any code

Prompt

Chat mode, do not edit files. I want to add rate limiting to the /api/upload route in this project. Read the route and its tests, then give me: the files you would change, the approach in three steps, the tests you would add, and anything in the existing code that makes this risky.

Sample output

Files: app/api/upload/route.ts, lib/rate-limit.ts (new), app/api/upload/route.test.ts. Approach: 1) add a fixed-window limiter keyed by user ID in lib/rate-limit.ts; 2) call it at the top of the POST handler and return 429 with a Retry-After header; 3) make the limit configurable through an environment variable. Tests: allows requests under the limit, returns 429 on the request that exceeds it, resets after the window. Risk: the handler currently reads the user from a header that is not validated, so limits keyed on it could be bypassed. Fix that first.

If the plan touches more files than you expected, narrow the task before switching to Code mode.

Execute one scoped change in Code mode

Prompt

Code mode. Implement step 1 of the plan only: create lib/rate-limit.ts with a fixed-window limiter and unit tests. Do not modify the route yet. Create a named checkpoint called "before-rate-limit" first, then run the tests and show me the result.

Sample output

Checkpoint created: before-rate-limit. Created lib/rate-limit.ts (fixed window, in-memory Map keyed by ID, limit and window passed as arguments). Created lib/rate-limit.test.ts with 4 tests. Ran the test suite: 4 passed, 0 failed. Not changed: app/api/upload/route.ts, as requested.

Review the diff yourself before moving to step 2. If anything looks wrong, revert to the named checkpoint rather than asking the agent to patch its own mistake.

Write a project rule so the agent follows your conventions

Prompt

Draft a short rules file for this repository that Cascade should follow on every task. Base it on what you can see in the code: language and framework versions, test command, folder conventions, and two things it must never do.

Sample output

- TypeScript strict mode, Next.js App Router. Server components by default; add "use client" only when state or browser APIs are needed. - Run tests with npm test before saying a task is done. - New utilities go in lib/, components in components/, one component per file. - Never edit files under migrations/ or .env*. - Never add a dependency without asking first.

Sources

Recommended AI Tools

Top-rated tools for this learning path, ranked by quality and ease of use.

Frequently asked questions

Is Windsurf still available?

Windsurf has been renamed Devin Desktop. Cognition says Devin Desktop builds on Windsurf's IDE foundation and that the full IDE experience remains accessible, with an agent command center added on top. The Windsurf documentation address now redirects to the Devin Desktop docs.

What is the difference between Code and Chat mode in Cascade?

Code mode lets Cascade change files and run tools in your project. Chat mode answers questions and helps plan without editing. Learning to plan in Chat and then execute narrowly in Code is the single habit that most reduces bad agent edits.

How do I undo changes the agent made?

Use named checkpoints and reverts. Create a checkpoint before a risky task and revert to it if the result is wrong. This is faster and safer than asking the agent to repair its own changes.

How do I stop the agent touching sensitive files?

Add the paths to a .devinignore file in the project (older projects may still use .codeiumignore). Ignored paths are files Cascade will not view, edit or create, which is the right place for secrets, migrations and generated files.

Do I need to be a developer to learn it?

You need to read code well enough to review a diff and run tests. The agent writes code quickly, but deciding whether a change is correct and safe is still your job, so learn it on a small project with tests rather than on production code.

Related Learning Guides

Windsurf (Codeium) Tutorial→Windsurf (Codeium) Training→Free Windsurf (Codeium) Course→Learn AI for Free→AI Tutorials for Beginners→AI Learning Path→

Explore All AI Learning Guides

πŸ€–ChatGPT🧠Claude✨Google GeminiπŸ”Perplexity AI🎨MidjourneyπŸ–ΌοΈStable Diffusion🎭DALLΒ·E 3🦁Leonardo AIπŸ”₯Adobe Firefly🎬Runway⚑Pika AIπŸŽ™οΈHeyGen⌨️Cursor AIπŸ™GitHub CopilotπŸ„Windsurf (Codeium)πŸ”ŠElevenLabs🎡Suno AIπŸ“Notion AI✍️Jasper AI🎨Canva AI

Compare plans and choose your workflow

Don't stop here

What to read next

Hand-picked guides our readers explore right after this one.