The Windsurf Browser is a fully functional browser that bridges the gap between your development workflow and web-based activities. Windsurf Browser runs a Chromium app on your device. Your storage, cookies, logins, Chrome profiles, etc. are securely stored locally and persisted between sessions. This empowers workflows by equipping Cascade with browser use tools like taking screenshots and DOM tree capture, as well as exposing browser content, history, and logs to Cascade in the form of @-mentions.
The Windsurf Browser is currently in beta and available to all free, Pro, and Teams users. Enterprise users will be rolling — reach out to learn more

​
How to Open

1

Open the Windsurf Browser

The Windsurf Browser can be launched by clicking the following button on the top right of the Windsurf surface:
Alternatively, you can also prompt Cascade to open the Browser by typing “Open Windsurf Browser”. This will invoke an open-browser tool call.Clicking any links from within the conversation panel will also open the Windsurf Browser.
2

Browse normally

Search the web and view webpages, documentation, Github issues etc and debug apps, just how you would normally use any other browser!
3

Send components to Cascade, or let Cascade reference it for you

Send page content like open tabs/pages, chunks of text, diagrams, logs, and more to Cascade.

​
Browser tools

Cascade has access to the following tools related to the Windsurf Browser:
  • Take Screenshot - Take a screenshot of the webpage.
  • Capture DOM Tree - Retrieves the DOM structure to identify and extract elements from the page.
  • Open URL - Navigates to a new URL in a new tab of the browser.
  • Retrieve Browser Pages - Retrieves the list of relevant open pages in the browser.
  • Read Browser Page - Reads the content of a specific page in the browser.
  • Capture Console Logs - Retrieve JavaScript console logs, errors, and debug output from browser pages.
  • Browser Preview - Spin up a browser preview for local web servers and development applications. You can open this in a new tab within the Windsurf Editor.

​
What Cascade Can Access

  • Page content - Text, code snippets
  • Console logs - JavaScript errors and debug output
  • DOM structure - HTML elements and page layout
  • Multiple tabs - Content across all open browser tabs
  • Interactive diagrams - Interactive figures, charts, and other components
For example, here are some useful things our team has tested and found value from:

Diagrams

Send JS-rendered interactive charts from Grafana, Google Analytics, Firebase Analytics, etc back into Cascade.

Analytics and Logs

Send logs from Jenkins and Github back into Cascade.

Technical Documentation

Works especially well in conjuction with our web and docs search tool.

​
Technical Notes

  • Built on Chromium in debug mode
  • Complete Chrome DevTools access
  • We use a dedicated debugging user profile for Windsurf
  • Works with all modern web standards

Chromium

Access the official Chromium documentation for more information.