> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Welcome to Windsurf Plugins

> Install and set up the Windsurf Plugin for JetBrains IDEs, including remote development environments, with AI-powered coding assistance.

**Windsurf Plugins** bring AI-powered coding assistance to JetBrains IDEs.

<Card title="Teams and Enterprise" icon="users" href="/desktop/accounts/teams-getting-started">
  Get started with your team!
</Card>

<CardGroup cols={3}>
  <Card
    title="Cascade"
    icon={
  <svg
    width="25"
    height="25"
    viewBox="0 0 1292 1292"
    fill="none"
    xmlns="http://www.w3.org/2000/svg"
  >
    <path
      d="M1195 599C1195 848.08 993.08 1050 744 1050C494.92 1050 293 848.08 293 599C293 349.92 494.92 148 744 148C993.08 148 1195 349.92 1195 599ZM411.5 599C411.5 782.635 560.365 931.5 744 931.5C927.635 931.5 1076.5 782.635 1076.5 599C1076.5 415.365 927.635 266.5 744 266.5C560.365 266.5 411.5 415.365 411.5 599Z"
      fill="#34E8BB"
    />
    <path
      d="M1096.19 1053.62C1116.8 1078.03 1113.86 1114.77 1087.65 1133.04C1002.41 1192.46 903.441 1229.92 799.584 1241.61C676.505 1255.46 552.082 1232.51 442.049 1175.65C332.016 1118.79 241.314 1030.58 181.415 922.172C130.87 830.693 104.172 728.301 103.33 624.396C103.071 592.449 131.338 568.79 163.173 571.479C195.007 574.168 218.29 602.208 219.218 634.143C221.573 715.175 243.206 794.78 282.679 866.22C331.512 954.6 405.457 1026.51 495.161 1072.87C584.866 1119.22 686.302 1137.94 786.643 1126.64C867.75 1117.51 945.198 1089.11 1012.66 1044.15C1039.24 1026.44 1075.58 1029.21 1096.19 1053.62Z"
      fill="#34E8BB"
    />
    <path
      d="M177.334 450.08C146.261 442.514 126.947 411.072 137.349 380.829C160.687 312.983 195.56 249.512 240.566 193.267C285.571 137.023 339.851 89.0802 400.928 51.4326C428.153 34.6511 463.065 46.5999 477.261 75.2582C491.457 103.917 479.508 138.389 452.641 155.738C406.542 185.506 365.436 222.584 330.994 265.627C296.552 308.67 269.39 356.906 250.456 408.411C239.421 438.428 208.408 457.646 177.334 450.08Z"
      fill="#34E8BB"
    />
  </svg>
}
    href="/windsurf/plugins/cascade/cascade-overview"
  >
    Windsurf's coding agent.
  </Card>

  <Card title="Usage" icon="bars-progress" href="/desktop/accounts/usage">
    Credits and usage.
  </Card>

  <Card title="Models" icon="robot" href="/windsurf/plugins/cascade/models">
    Models available for use.
  </Card>
</CardGroup>

## JetBrains (Local)

<Warning>
  **The Windsurf JetBrains plugin is in maintenance mode** and Cascade is being deprecated. Newer JetBrains IDE releases can break the legacy plugin. We recommend switching to Devin over ACP — see the [JetBrains ACP setup guide](/cli/acp/jetbrains).
</Warning>

<Note>
  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.
</Note>

<Note>
  For remote development environments, use the [Devin ACP](/cli/acp/jetbrains) in Jetbrains IDEs instead.
</Note>

<Steps>
  <Step title="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.

    <Frame>
      <img src="https://mintcdn.com/cognitionai/-PTA3zzo2bR9Qfc8/desktop/assets/jetbrains_plugin_install.png?fit=max&auto=format&n=-PTA3zzo2bR9Qfc8&q=85&s=dd4f7af540fb84d92187b363bca749e5" width="1368" height="1052" data-path="desktop/assets/jetbrains_plugin_install.png" />
    </Frame>
  </Step>

  <Step title="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.

    <Frame>
      <img src="https://mintcdn.com/cognitionai/-PTA3zzo2bR9Qfc8/desktop/assets/jetbrains_ls_download_bar.png?fit=max&auto=format&n=-PTA3zzo2bR9Qfc8&q=85&s=7c42a7e984909d4c116541d29e27c821" width="1174" height="158" data-path="desktop/assets/jetbrains_ls_download_bar.png" />
    </Frame>
  </Step>

  <Step title="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.

    <Frame>
      <img src="https://mintcdn.com/cognitionai/-PTA3zzo2bR9Qfc8/desktop/assets/jetbrains_login_widget.png?fit=max&auto=format&n=-PTA3zzo2bR9Qfc8&q=85&s=b3d4fedf3729ea04c72acf6ee7db8fc7" width="690" height="230" data-path="desktop/assets/jetbrains_login_widget.png" />
    </Frame>

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

    <Frame>
      <img src="https://mintcdn.com/cognitionai/-PTA3zzo2bR9Qfc8/desktop/assets/login_prompt_webpage.png?fit=max&auto=format&n=-PTA3zzo2bR9Qfc8&q=85&s=2dc52c3a7979daa299dc7b652d74cad5" width="1896" height="1442" data-path="desktop/assets/login_prompt_webpage.png" />
    </Frame>

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

    <Frame>
      <img src="https://mintcdn.com/cognitionai/-PTA3zzo2bR9Qfc8/desktop/assets/login_successful_webpage.png?fit=max&auto=format&n=-PTA3zzo2bR9Qfc8&q=85&s=c4b3cfae5544a8dfcb6199fd3cf3af80" width="1702" height="450" data-path="desktop/assets/login_successful_webpage.png" />
    </Frame>
  </Step>

  <Step title="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](https://plugins.jetbrains.com/plugin/20540-windsurf-plugin-for-python-js-java-go--/versions/pre-release)
    of the plugin.

    <Frame>
      <img src="https://mintcdn.com/cognitionai/-PTA3zzo2bR9Qfc8/desktop/assets/jetbrains_status_bar.png?fit=max&auto=format&n=-PTA3zzo2bR9Qfc8&q=85&s=b6306ecf96e52ca33a184a1b6ea76912" width="688" height="542" data-path="desktop/assets/jetbrains_status_bar.png" />
    </Frame>
  </Step>
</Steps>

### Remote Development

<Warning>
  **This plugin is no longer maintained.** We highly recommend using the [Devin ACP](/cli/acp/jetbrains) in Jetbrains IDEs instead.
</Warning>

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

#### Requirements

* JetBrains IDE version 2025.1.3 or greater

#### Installation Steps

<Steps>
  <Step title="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.

    <Frame>
      <img src="https://mintcdn.com/cognitionai/-PTA3zzo2bR9Qfc8/desktop/assets/jetbrains_remote_plugin_install_host.png?fit=max&auto=format&n=-PTA3zzo2bR9Qfc8&q=85&s=773357231fb9838593fdceed36a10383" width="1494" height="1110" data-path="desktop/assets/jetbrains_remote_plugin_install_host.png" />
    </Frame>
  </Step>

  <Step title="Install on Client">
    Open the `Plugins (Client)` menu and search for **"Windsurf (Remote Development)"**.
    Install the plugin and restart the IDE again.

    <Frame>
      <img src="https://mintcdn.com/cognitionai/-PTA3zzo2bR9Qfc8/desktop/assets/jetbrains_remote_plugin_install_client.png?fit=max&auto=format&n=-PTA3zzo2bR9Qfc8&q=85&s=3537fc3ebc5fe924a6d1c5f342e8a433" width="1496" height="1098" data-path="desktop/assets/jetbrains_remote_plugin_install_client.png" />
    </Frame>
  </Step>

  <Step title="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.

    <Frame>
      <img src="https://mintcdn.com/cognitionai/-PTA3zzo2bR9Qfc8/desktop/assets/jetbrains_ls_download_bar.png?fit=max&auto=format&n=-PTA3zzo2bR9Qfc8&q=85&s=7c42a7e984909d4c116541d29e27c821" width="1174" height="158" data-path="desktop/assets/jetbrains_ls_download_bar.png" />
    </Frame>
  </Step>

  <Step title="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.

    <Frame>
      <img src="https://mintcdn.com/cognitionai/-PTA3zzo2bR9Qfc8/desktop/assets/jetbrains_login_widget.png?fit=max&auto=format&n=-PTA3zzo2bR9Qfc8&q=85&s=b3d4fedf3729ea04c72acf6ee7db8fc7" width="690" height="230" data-path="desktop/assets/jetbrains_login_widget.png" />
    </Frame>

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

    <Frame>
      <img src="https://mintcdn.com/cognitionai/-PTA3zzo2bR9Qfc8/desktop/assets/login_prompt_webpage.png?fit=max&auto=format&n=-PTA3zzo2bR9Qfc8&q=85&s=2dc52c3a7979daa299dc7b652d74cad5" width="1896" height="1442" data-path="desktop/assets/login_prompt_webpage.png" />
    </Frame>

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

    <Frame>
      <img src="https://mintcdn.com/cognitionai/-PTA3zzo2bR9Qfc8/desktop/assets/login_successful_webpage.png?fit=max&auto=format&n=-PTA3zzo2bR9Qfc8&q=85&s=c4b3cfae5544a8dfcb6199fd3cf3af80" width="1702" height="450" data-path="desktop/assets/login_successful_webpage.png" />
    </Frame>
  </Step>

  <Step title="All Done!">
    You're all set. Windsurf's AI features are now available in your remote environment.
  </Step>
</Steps>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.