> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Welcome to Devin Desktop
> Download and install Devin Desktop IDE for Mac, Windows, or Linux. Import VS Code or Cursor settings, configure themes, and start coding with AI-powered assistance.
Tomorrow's editor, today.
Devin Desktop is a next-generation AI IDE built to keep you in the flow. On this page, you'll find instructions on how to install Devin Desktop on your computer, navigate the onboarding flow, and get started with your first AI-powered project.
Our next-generation agent harness, shared with Devin CLI. Runs on your machine as the primary local agent.
Credits and usage.
An upgraded Terminal experience.
MCP servers extend the agent's capabilities.
Memories and rules help customize behavior.
Instantly understands your codebase.
Advanced configuration options.
Automate repetitive trajectories.
Deploy applications in one click.
See what's new with Devin Desktop in our [changelog](https://windsurf.com/changelog)!
In some cases Devin Desktop may not function exactly as referenced, or documentation may be out of date.
## Set Up
To get started, please ensure that your device meets the requirements, click the download link, and follow the instructions to install and run Devin Desktop.
[Click here](#update-devin-desktop) if you're looking for how to update Devin Desktop.
Minimum OS Version: OS X Yosemite
Minimum OS Version: Windows 10
Minimum Requirements: glibc >= 2.28, glibcxx >= 3.4.25 (e.g. Ubuntu 20, Debian 10, Fedora 36, RHEL 8)
## Onboarding
Once you have Devin Desktop running, you will see the page below. Let's get started! Note that you can always restart this onboarding flow with the "Reset Onboarding" command.
### 1. Select setup flow
If you're coming from VS Code or Cursor, you can easily import your configurations. Otherwise, select "Start fresh". You can also optionally install `windsurf` in PATH such that you can run `windsurf` from your command line.
Choose your keybindings here, either default VS Code bindings or Vim bindings.
You can migrate your settings, extensions, or both here.
You can migrate your settings, extensions, or both here.
### 2. Choose editor theme
Choose your favorite color theme from these defaults! Don't worry, you can always change this later. Note that if you imported from VS Code, your imported theme will override this.
### 3. Sign up / Log in
To use Devin Desktop, you need to use your Devin Desktop account or create one if you don't have one. Signing up is completely free!
Once you've authenticated correctly, you should see this page. Hit "Open Windsurf" and you're good to go!
#### Having Trouble?
If you're having trouble with this authentication flow, you can also log in and manually provide Devin Desktop with an authentication code.
Click the "Copy link" button to copy an authentication link to your clipboard and enter this link into your browser.
Copy the authentication code displayed in the link and enter it into Devin Desktop.
### 4. Let's Surf!
Explore some of our recommended plugins to get the most out of Devin Desktop!
## Update Devin Desktop
To update Devin Desktop, you can click on the "Restart to Update ->" button in the top right corner of the menu bar.
If you are not seeing this button, you can:
1. Click on your Profile icon dropdown > Check for Updates
2. In the Command Palette (`Cmd/Ctrl+Shift+P`) > "Check for Updates"
## Things to Try
Now that you've successfully opened Devin Desktop, let's try out some of the features! These are all conveniently accessible from the starting page. :)
On the right side of the IDE, you'll notice the agent panel. This is your AI-powered code assistant! You can chat, write code, and run code with it. Learn more about [Devin Local](/desktop/devin-local).
You can create brand new projects with the agent! Click the "New Project" button to get started.
You can open a folder or connect to a remote server via SSH or a local dev container. Learn more [here](/desktop/advanced).
Click on the "Windsurf - Settings" button on the bottom right to pop up the settings panel. To access Advanced Settings, click on the button in this panel or select "Windsurf Settings" in the top right profile dropdown.
You can open the command palette with the `⌘+⇧+P` (on Mac) or `Ctrl+Shift+P` (on Windows/Linux) shortcut. Explore the available commands!
## Forgot to Import VS Code Configurations?
You can easily import your VS Code/Cursor configuration into Devin Desktop if you decide to do so after the onboarding process.
Open the command palette (Mac: `⌘+⇧+P`, Windows/Linux: `Ctrl+Shift+P`) and type in the following:
## Incompatible Extensions
There are a few extensions that are incompatible with Devin Desktop. These include other AI code complete extensions and proprietary extensions. You cannot install extensions through any marketplace on Devin Desktop.
## Custom App Icons (beta)
For paying users of Devin Desktop, you can choose between different Devin Desktop icons while it sits in your dock. Currently, this feature is only available for Mac OS, with other operating systems coming soon.
To change your app icon, simply click the profile/settings icon in the top right corner of the editor and select "Customize App Icon".
## Devin Desktop Next
Devin Desktop Next is a prerelease version of Devin Desktop which users can choose to opt-in to access the newest features and capabilities as early as possible, even if the features are not fully polished. Features will typically be rolled out to Devin Desktop Next first, and then into the stable release shortly after.
You can opt-in to Devin Desktop Next simply by [downloading it here](https://windsurf.com/editor/download-next).
## Uninstall Devin Desktop
To uninstall Devin Desktop from your system, follow these steps:
Ensure that Devin Desktop is not currently running before proceeding with the uninstallation.
Drag the Devin Desktop application from the Applications folder to the Trash.
The application is usually located in one of these folders:
* `C:\Program Files\Windsurf`
* `C:\Users\[YourUsername]\AppData\Local\Programs\Windsurf`
Delete the Devin Desktop folder from the appropriate location.
Remove the Devin Desktop folder from the location where you installed it.
Delete the Devin Desktop configuration folder:
```bash theme={null}
rm -rf ~/.codeium/windsurf
```
Delete the Devin Desktop configuration folder:
```
C:\Users\[YourUsername]\.codeium\windsurf
```
If you installed Devin Desktop in PATH, remove it from your system's PATH environment variable.
If you installed Devin Desktop using your system's package manager or control panel, you can also use that to uninstall it.
Empty your Trash or Recycle Bin to complete the uninstallation.
### 1. Select setup flow
If you're coming from VS Code or Cursor, you can easily import your configurations. Otherwise, select "Start fresh". You can also optionally install `windsurf` in PATH such that you can run `windsurf` from your command line.
### 3. Sign up / Log in
To use Devin Desktop, you need to use your Devin Desktop account or create one if you don't have one. Signing up is completely free!
Once you've authenticated correctly, you should see this page. Hit "Open Windsurf" and you're good to go!
#### Having Trouble?
If you're having trouble with this authentication flow, you can also log in and manually provide Devin Desktop with an authentication code.
If you are not seeing this button, you can:
1. Click on your Profile icon dropdown > Check for Updates
2. In the Command Palette (`Cmd/Ctrl+Shift+P`) > "Check for Updates"
## Things to Try
Now that you've successfully opened Devin Desktop, let's try out some of the features! These are all conveniently accessible from the starting page. :)
On the right side of the IDE, you'll notice the agent panel. This is your AI-powered code assistant! You can chat, write code, and run code with it. Learn more about [Devin Local](/desktop/devin-local).
You can create brand new projects with the agent! Click the "New Project" button to get started.
You can open a folder or connect to a remote server via SSH or a local dev container. Learn more [here](/desktop/advanced).
Click on the "Windsurf - Settings" button on the bottom right to pop up the settings panel. To access Advanced Settings, click on the button in this panel or select "Windsurf Settings" in the top right profile dropdown.
You can open the command palette with the `⌘+⇧+P` (on Mac) or `Ctrl+Shift+P` (on Windows/Linux) shortcut. Explore the available commands!
