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.
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
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
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
Sources
Recommended AI Tools
Top-rated tools for this learning path, ranked by quality and ease of use.
ChatGPT
The world's most popular AI chatbot
Claude
Safe, thoughtful AI with a context window of up to 1M tokens
Cursor
AI-first code editor built for 10x productivity
GitHub Copilot
AI pair programmer built into your IDE
v0 by Vercel
AI that generates React UI components instantly
Replit
Browser-based coding with built-in AI
Phind
AI search engine for developers
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.