Smithery is now a part of Arcade.dev! Read more in our announcement here
Create a minimal working Windsurf example. Use when starting a new Windsurf integration, testing your setup, or learning basic Windsurf API patterns. Trigger with phrases like "windsurf hello world",...
Devin Desktop is the current name for Windsurf. This walkthrough exercises Cascade Code and Chat modes, Supercomplete, and inline Command editing with a disposable example.
windsurf-install-auth setupRead to inspect only the repository files and configuration needed for the request.Write only for a new artifact the user requested; never write credentials or unreviewed production configuration.Edit for bounded, reviewable changes and preserve unrelated user work.Open any code file and start typing. Supercomplete predicts your intent based on recent edits, cursor movement, and surrounding context.
// Type this in a new file: hello.ts
// After typing "function greet", Supercomplete suggests the rest
function greet(name: string): string {
// Just type "return" and press Tab -- Supercomplete fills the template literal
return `Hello, ${name}! Welcome to Windsurf.`;
}
// Start typing "const users" -- Supercomplete predicts array based on greet() context
const users = ["Alice", "Bob", "Charlie"];
users.forEach(user => console.log(greet(user)));
Key Supercomplete behaviors:
Open Cascade and select Code mode. Use the visible command or current keybinding because imported editor profiles can change shortcuts.
Prompt to try:
"Create a REST API endpoint in src/api.ts using Express that serves
the greet function. Include error handling for missing name parameter."
Cascade will:
src/api.ts with Express setupReview and accept/reject each file change before Cascade proceeds.
Switch to Chat mode (toggle in Cascade panel) for questions that don't need file edits:
Prompt: "Explain the difference between Code and Chat mode in Cascade"
Expected response: Code mode can create/modify files and run terminal commands.
Chat mode answers questions without touching your codebase.
Highlight a block of code in the editor and press Cmd/Ctrl+I to invoke Command mode:
Select the greet function, then type:
"Add JSDoc documentation and input validation"
Cascade edits the selected code inline and presents a diff for explicit acceptance or rejection.
In Cascade chat, use @ to inject specific context:
@src/api.ts -- reference a specific file
@src/ -- reference an entire directory
@web -- search the web for current info
Example prompt with context:
"@src/api.ts Add rate limiting middleware to all endpoints"
| Issue | Cause | Solution |
|---|---|---|
| No Supercomplete suggestions | Extension disabled | Click status bar widget, enable autocomplete |
| Cascade not editing files | In Chat mode | Switch to Code mode in Cascade panel |
| Slow Cascade response | Large workspace | Add .codeiumignore for build artifacts |
| @ mention not working | File not indexed | Wait for indexing to complete (status bar) |
Press Cmd/Ctrl+I in the terminal, then type:
"Find all TypeScript files that import express"
Windsurf generates: find src -name "*.ts" -exec grep -l "express" {} \;
Ask Cascade: "Preview the API server in the browser"
Windsurf opens an in-IDE preview tab with your running app.
Click elements in the preview to send them back to Cascade for edits.
Continue with windsurf-local-dev-loop to turn this disposable exercise into a repeatable, test-gated development workflow for a real repository.
