wbmeet

How to install and use Windsurf Cascade: editor, sign-in, first repo task

Install the standalone Windsurf editor, sign in so Cascade works, then land one reviewable diff in your own repo.

The first hour with Windsurf Cascade usually breaks on the installer, a skipped sign-in, or a first task with no reviewable diff. Install the standalone editor from the official site, sign in, open Cascade, then change one reversible line in a repo you own.

The query is how to install and use Windsurf Cascade. This page follows official getting-started and Cascade notes at windsurf.com and docs.devin.ai/windsurf. It is the agent inside a VS Code–based desktop IDE, not this site’s meeting product. To walk a diff on a short call, open a room on wbmeet; see how to create and join a room.

Install the editorSign inOne repo task

Check what you are installing

Windsurf is a standalone app, not a required extension inside an existing VS Code window. Cascade is fully usable after you sign in. A free tier exists; credits and models follow the official pricing page. Enterprise seats may be limited by an admin.

3 OS
macOS / Windows / Linux
L
Cmd or Ctrl + L opens Cascade
1×
Sign-in to enable the agent

First hour: install, sign in, land a reviewable change

  1. 1

    Install the editor from the official site

    Open windsurf.com, pick the macOS, Windows, or Linux installer, and install it like any desktop app. Skip unofficial mirrors. First launch may offer to import VS Code settings, keybindings, and extensions.

  2. 2

    Sign in so Cascade can run

    Create or sign in with email, Google, or GitHub. If you skipped the dialog, run Sign in from the command palette or the status-bar account widget. Without a session, the Cascade panel is often empty or cannot send.

  3. 3

    Open a repo you own

    File → Open Folder on a project you can roll back. Do not use a production secrets directory for the first experiment.

  4. 4

    Open Cascade and give a reviewable task

    Cmd+L on macOS or Ctrl+L on Windows/Linux, or the Cascade icon. Write mode edits files; Chat mode answers questions. Ask what the project does and where the entry point is, then: “Add a unit test for one untested helper, or input checks on one public function. Show the diff and wait for Accept.” Do not paste secrets.

# First hour · Windsurf Cascade · as of 2026-09
# 1. Download installer from https://windsurf.com
# 2. Sign in (email / Google / GitHub)
# 3. File → Open Folder → your repo
# 4. Cmd+L (macOS) or Ctrl+L (Windows/Linux)
# Write mode, then:
# "Add a unit test for one untested helper; show the diff and wait."

Install paths, modes, pitfalls

PathWhat official docs sayFirst-hour note
Standalone editorInstaller on windsurf.comNo unofficial mirrors
Sign-inAccount required for full CascadeSkipping login disables the agent
Write / ChatEdits vs Q&AConfirm Write before file edits
ShortcutCmd/Ctrl+LNo panel? Check sign-in first
Extension clashVS Code–compatible extensionsDisable competing Copilot autocomplete
01

Cascade stays silent

Usually unsigned or an expired token. Sign out, sign in, restart. Confirm the machine can reach official services.

02

Duplicate or fighting suggestions

Common with GitHub Copilot still enabled. Turn competing autocomplete off and keep Cascade.

03

First task stayed a chat

“What does this repo do” is warmup. Finish with a reviewable change and read the diff before Accept.

Official Getting started and Cascade overview: install the standalone editor, sign in, then Cmd/Ctrl+L. Commands and credits follow the live site.

Editor ≠ required VS Code plugin
This page covers standalone Windsurf. Plugin paths have fewer agent features; start with the official editor.
Write vs Chat
Use Write to change files; use Chat to explain. Avoid Accept All on a pile of unread diffs.
This is not a meeting-product guide
Only the first hour of Cascade. Short whiteboard call: wbmeet or when not to open another heavy meeting app.

Questions worth checking

Do I have to pay to use Cascade?

Official docs offer a signed-in free tier to try. Credits, models, and advanced agent features follow current pricing and account type. Do not assume unlimited quota.

Can I stay in my existing VS Code?

There is a plugin path, but full agent features are in standalone Windsurf. Install the editor first, then decide on plugins.

The shortcut does not open Cascade?

Confirm you are signed in. Try the sidebar icon or the command palette. Imported VS Code keybindings can steal Cmd/Ctrl+L.

Must the first task touch production code?

No. Ask what the project does, then one reversible change (test or validation) and read the diff first.

Start a free meeting