Welcome to Windsurf Plugins

Install and set up Windsurf Plugins for JetBrains, VS Code, Visual Studio, Vim, NeoVim, Jupyter, Chrome, and other IDEs with AI-powered coding assistance.

Windsurf Plugins bring AI-powered coding assistance to your preferred IDE or editor.

Teams and Enterprise

Get started with your team!

Cascade

Windsurf’s coding agent.

Usage

Credits and usage.

Models

Models available for use.

JetBrains (Local)

These steps do not apply for enterprises on a self-hosted plan. If you are an enterprise user, please refer to the instructions in your enterprise portal.

For remote development environments, use the “Windsurf (Remote Development)” plugin instead. See the Remote Development section below.

1. Install Local Plugin

   Open the Plugins menu in your JetBrains IDE. The shortcut for this is ⌘+, on Mac and Ctrl+, on Linux/Windows. It is also accessible from the settings menu. Search for the Windsurf plugin, and install it. The plugin loader will prompt you to restart the IDE.

   
2. Wait for Language Server

   Upon successful installation, Windsurf will begin downloading a language server. This is the program that communicates with our APIs to let you use Windsurf’s AI features. The download usually takes ten to twenty seconds, but the download speed may depend on your internet connection. In the meantime, you are free to use your IDE as usual.

   You should see a notification on the bottom right to indicate the progress of the download.

   
3. Authorize

   Open a project. Windsurf will prompt you to sign in with a notification popup at the bottom right linking you to a login page. Equivalently, click the widget at the right of the bottom status bar and select the login option there.

   

   If you’re not already signed in, you’ll be prompted to sign in or create an account.

   

   Once you’ve signed in, the webpage will indicate that you can return to your IDE.

   
4. All Done!

   You’re all set. Windsurf’s AI features — Autocomplete, Chat, Command, and more — are now available.

   At any point, you can check your status by clicking the status bar widget at the bottom right. If signed in, you will have access to your Windsurf settings and other controls.

   If you’d like early access to new features, click on “Switch to Pre-Release” to try out the latest pre-release version of the plugin.

   

Remote Development

For JetBrains IDEs used in remote development environments, you need to use the separate “Windsurf (Remote Development)” plugin.

For advanced agentic AI capabilities and cutting-edge features, we strongly recommend using the native Windsurf Editor or the JetBrains local plugin. This plugin continues to receive the latest models, compatibility updates, and bug fixes, but does not include newer features exclusive to the Windsurf Editor.

Requirements

• JetBrains IDE version 2025.1.3 or greater

Installation Steps

1. Install on Host

   Open the Plugins (Host) menu in your JetBrains IDE. The shortcut for this is ⌘+, on Mac and Ctrl+, on Linux/Windows. It is also accessible from the settings menu. Search for “Windsurf (Remote Development)” and install it. Restart your IDE when prompted.

   
2. Install on Client

   Open the Plugins (Client) menu and search for “Windsurf (Remote Development)”. Install the plugin and restart the IDE again.

   
3. Wait for Language Server

   After installing the plugin on the host, Windsurf will begin downloading a language server. This is the program that communicates with our APIs to let you use Windsurf’s AI features. The download usually takes ten to twenty seconds, but the download speed may depend on your internet connection. In the meantime, you are free to use your IDE as usual.

   You should see a notification on the bottom right to indicate the progress of the download.

   
4. Authorize

   After the language server download is completed, Windsurf will prompt you to sign in with a notification popup at the bottom right linking you to a login page. Equivalently, click the widget at the right of the bottom status bar and select the login option there.

   

   If you’re not already signed in, you’ll be prompted to sign in or create an account.

   

   Once you’ve signed in, the webpage will indicate that you can return to your IDE.

   
5. All Done!

   You’re all set. Windsurf’s AI features are now available in your remote environment.

Older Plugins

We strongly recommend using the native Windsurf Editor or the JetBrains local plugin for their advanced agentic AI capabilities and cutting-edge features. The plugins below are in maintenance mode.

Visual Studio Code

1. Install Plugin

   Find the Windsurf Plugin (formerly Codeium) in the VS Code Marketplace and install it.

   
2. Authorize

   After installation, VS Code will prompt you with a notification in the bottom right corner to sign in to Windsurf. Equivalently, you can sign in to Windsurf via the profile icon at the bottom of the left sidebar.

   

   

   Once you sign in, you’ll be redirected back to Visual Studio Code.

3. Wait for Language Server

   Once you’re signed in, Windsurf will start downloading a language server. This is the program that communicates with our APIs to let you use Windsurf’s AI features. The download usually takes ten to twenty seconds, but the download speed may depend on your internet connection. In the meantime, you are free to use VS Code as usual.

4. All Done!

   You’re all set. Windsurf’s AI features — Autocomplete, Chat, and Command — are now available.

Vim / Neovim

Extension Installation

1. Install Plugin

   Follow the Get Started instructions in the public codeium.vim repo. That’s it!

Using Windsurf Plugin

1. Setup

   While Windsurf supports many languages, we’ll demonstrate with Python. Create a new file test.py.

2. From Code

   Windsurf can suggest multiple lines of code from a partial function header:

   
3. Accept Suggestion

   Press Tab to accept.

4. From Comments

   Windsurf also understands comments:

   

Visual Studio

Extension Installation

1. Open Extension Marketplace

   In the Visual Studio menu bar, click Extensions → Manage Extensions.

   
2. Install Windsurf Plugin

   In Manage Extensions, click Visual Studio Marketplace, search for Windsurf, then click Download.

   
3. Relaunch Visual Studio

   Close the window and relaunch Visual Studio.

4. Sign in to Windsurf Plugin

   Open or create a project. A browser window will open and prompt you to sign in.

5. Create Account

   If you don’t have an account yet, you’ll be redirected to create one.

6. All Done!

   You’re all set. Windsurf’s AI features are now available in Visual Studio.

Using Windsurf Plugin

1. Setup

   While Windsurf supports many languages, we’ll demonstrate with C#. Create or open a C# file.

2. From Code

   Windsurf can suggest multiple lines of code from a partial function signature:

   
3. Accept Suggestion

   Press Tab to accept.

   

Jupyter Notebook

Install Windsurf Plugin

1. Install Jupyter Extension

   Open a new Jupyter Lab session. In a cell, paste and run Shift+Enter the following:

   import sys
   !{sys.executable} -m pip install -U pip --user
   !{sys.executable} -m pip install -U codeium-jupyter --user
   

   If you’re inside a virtual environment, run:

   import sys
   !{sys.executable} -m pip install -U pip
   !{sys.executable} -m pip install -U codeium-jupyter
   

   When the commands finish, close the notebook and stop the Jupyter server.

2. Launch Jupyter

   Relaunch Jupyter and open a notebook. Open the settings (Ctrl + ,) and navigate to the Windsurf section. You’ll see fields for an enterprise URL and a token.

   

   Click Get Windsurf Authentication Token and follow the link. Paste the token back into the settings dialog.

   

   If you can’t find the Windsurf settings, you likely didn’t restart Jupyter. Stop the server (Ctrl+C) and start it again with jupyter lab.
3. Create Account

   If you don’t have a Windsurf account, you’ll be prompted to create one.

4. Authenticate

   After signing in, copy the token and paste it into the settings dialog.

   
5. All Done!

   You’re all set. Windsurf’s AI features are now available in Jupyter.

Using Windsurf Plugin

1. From Code

   Windsurf can suggest multiple lines of code from a partial function header:

   
2. Accept Suggestion

   Press Tab to accept.
3. From Comments

   Windsurf also understands comments:

   

Chrome

Install Windsurf

1. Install Chrome Extension

   Visit the Chrome Web Store page and click Add to Chrome.

   
2. Pin Extension

   Open the extensions dropdown and click the Pin icon so the Windsurf icon stays visible.

   
3. Sign In

   The extension opens a login page automatically. If not, click the extension icon and follow the link.

   
4. All Done!

   You’re all set. Try creating a new Colab notebook.

   

Using Windsurf

1. From Code

   Windsurf can suggest multiple lines of code from a partial function header:

   
2. Accept Suggestion

   Press Tab to accept.
3. From Comments

   Windsurf also understands comments:

   

Eclipse

Extension Installation

1. Drag the Install button

   Visit the Windsurf Plugin page on Eclipse Marketplace and drag the Install button to the Eclipse toolbar.

   
2. Confirm Selected Features

   In the Confirm Selected Features prompt, click Confirm.

   
3. Trust Unsigned Content

   In the Trust Artifacts prompt, select Unsigned and click Trust.

   
4. Restart Eclipse

   When prompted, restart Eclipse to complete the installation.

   
5. Create / Sign In

   When the browser opens, sign in or create an account, then return to Eclipse.

6. All Done!

   You’re all set. Windsurf’s AI features are now available in Eclipse.

Using Windsurf

1. Setup

   While Windsurf supports many languages, we’ll demonstrate with Java. Create a new file Fib.java.

2. From Code

   Windsurf can suggest multiple lines of code from a partial function header:

   package test;
   
   public class Fib {
   
       public int fib(int n) {
       }
   
   }
   
3. Accept Suggestion

   Press Tab to accept.