Control Windsurf (Cascade) from your phone
CodeAgent Mobile is a mobile companion app that lets you control Windsurf and its Cascade agent from your phone. Install the CodeAgent Mobile extension from Open VSX into Windsurf, pair the IDE with the app, then send prompts and stream Cascade's responses, diffs, and tool calls directly to iOS or Android.
How it works
Pair your phone with Windsurf (Cascade) once. After that, every prompt and response flows between the two automatically.
- 1
Open Windsurf and go to the Extensions panel (Cmd/Ctrl+Shift+X). Search for "CodeAgent Mobile" — Windsurf uses Open VSX, which is where CodeAgent Mobile publishes.
- 2
Click Install. A "CodeAgent Mobile" sidebar appears with the pairing controls.
- 3
Click Pair Device — a 6-character code and QR appear.
- 4
Open CodeAgent Mobile on your phone, tap "Pair Device", scan the QR or enter the code, and confirm.
- 5
Type a prompt in the mobile app — Cascade runs in Windsurf locally and streams the response, diffs, and tool calls back to your phone.
Why developers use it
A real remote control for your AI coding agent — not a chat fallback.
Real-time streaming
Token-by-token output streams from your laptop straight to your phone — diffs, file lists, and the agent's reasoning all render live.
Secure end-to-end relay
The CodeAgent backend is a thin relay. Your code never leaves your machine, and the AI agent runs with your existing API key or subscription.
Works with your existing setup
No changes to your IDE settings, Anthropic key, GitHub Copilot subscription, or Cursor account. Pair once and start sending prompts.
Approve interactive prompts
When the agent stops to ask y/n or pick an option, the prompt appears on your phone. Tap to approve, reject, or pick — without going back to the keyboard.
Frequently asked questions
Specific to Windsurf (Cascade) users.
Get started in under a minute
Install the Windsurf (Cascade) client, pair your phone, and start sending prompts from anywhere.