Skip to main content
The Windsurf JetBrains plugin is in maintenance mode and Cascade is being deprecated. Newer JetBrains IDE releases can break the legacy plugin. If Cascade or the plugin stopped working, switch to Devin over ACP — see the JetBrains ACP setup guide.

​
Supported Versions

Version 2022.3 or greater.

​
Gathering extension logs

Use one of these options to download a diagnostics file:
  • In the Cascade panel, click the three dots in the upper right, then click Download Diagnostics.
  • In the IDE menu, go to Tools > Windsurf > Download Windsurf Diagnostics.
The full IDE log is the idea.log file:
  1. To find this file, go to Help > Show Log in Finder/Explorer.
  2. Export or copy the logs.

​
Known IDE issues and solutions

​
Cascade not being displayed

Usually, you will see the following error in the logs:
or
JCEF is a browser needed to display Cascade. To fix this, go to Help > Find Actions > Choose Java Boot Runtime and pick a runtime with a bundled JCEF. If you already have JCEF bundled as part of your runtime, JCEF may be disabled in your registry/properties. Edit your properties: Help > Edit Custom Properties, add the following flag and restart your IDE:

​
Certificate Issues

If you encounter the following errors:
This error shows that the Windsurf plugin does not trust the TLS connection to your enterprise portal or API server. The plugin does not trust the certificate that it receives. Your enterprise deployment or a corporate proxy can present this certificate. In either case, the most preferable solution is to ensure that the root certificate that signed this certificate is properly installed on end-user machines in the appropriate location. JetBrains IDEs and most other IDEs load certificates from the operating system’s default location. Your certificate is issued and managed by your local IT or Admin team. Please reach out to them for assistance with installing the necessary certificates on your system. It is important that the full certificate chain is being presented from wherever TLS is being terminated. Oftentimes, if only the leaf certificate is presented, JetBrains IDE and other IDEs are unable to verify its authenticity because they are not aware of the intermediate certificate which validates the leaf certificate and is validated by the root certificate. Browsers are often able to work around this issue as users will likely have encountered a different website that does present the full certificate chain, so the intermediate cert is seen and cached, but applications like JetBrains IDEs don’t have this advantage. Note: In JetBrains family products 2024.3, a bug was introduced in which the IDE is failing to accept the OS certificates (JetBrains issue report). To solve this, users can do any of the following:
  • Downgrade JB products to earlier versions
  • Use the 2024.3.1 preview version (beta version)
  • Add -Djavax.net.ssl.trustStoreType=Windows-ROOT as a custom JVM option

​
Custom Workspaces

If you see the following error when using Cascade:
This indicates that Cascade needs access to a custom workspace to function properly. To resolve this:
  1. Open your JetBrains IDE Settings by going to File > Settings (or IntelliJ IDEA > Preferences on macOS)
  2. Navigate to Tools > Windsurf Settings
  3. In the Windsurf Settings panel, find the Custom Workspaces section. The local plugin shows Tracked Workspaces to non-enterprise users. The remote plugin shows this section only to enterprise users.
  4. Click the “Add Workspace” button to add your project workspace
  5. Select the appropriate workspace directory for your project
  6. Click “OK” to apply the settings
  7. Restart your IDE for the changes to take effect

​
Enterprise vs Non-Enterprise Behavior

The behavior of custom workspaces differs depending on your user type:

​
Enterprise Users

Enterprise users have selective control over workspace indexing:
  • In the local plugin, each workspace has a Tracked checkbox that enables indexing
  • Only workspaces with the checkbox selected are indexed
  • Workspaces without the checkbox are not indexed, but tool calls can use them
  • The remote plugin has no Tracked checkbox and does not index custom workspaces
  • This allows you to control which workspaces consume indexing resources

​
Non-Enterprise Users

Non-enterprise users get automatic workspace indexing:
  • Any workspace you add is automatically indexed without requiring a checkbox
  • All added workspaces are immediately available to Cascade
  • The selective indexing feature is not relevant under this model

​
Tool Call Restriction

The team setting Restrict Cascade to workspace is off by default. The legacy team portal calls this setting Restrict Tool Calls to Workspace (Alpha). When a team admin turns on this setting, tool calls can use only the active workspace and custom workspaces. After you complete these steps, Cascade can access your workspace.

​
Keyboard Shortcuts Not Working in Rider on Windows

If you are using JetBrains Rider on Windows and experience issues where Shift+Enter does not create a new line in Cascade, or the Delete key does not work, this is caused by a keybinding conflict with Rider’s Unit Test Tool Window. This is a known issue affecting AI plugins in Rider. To resolve this:
  1. Open your JetBrains IDE Settings by going to File > Settings
  2. Navigate to Keymap
  3. Search for “Unit Test Tool Window Action”
  4. Disable or reassign the conflicting keybindings (Shift+Enter and Delete)
  5. Restart your IDE for the changes to take effect