> ## 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 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.

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.

<Card title="Devin Local" icon="microchip" href="/desktop/devin-local">
  Our next-generation agent harness, shared with Devin CLI. Runs on your machine as the primary local agent.
</Card>

<CardGroup cols={2}>
  <Card title="Usage" icon="bars-progress" href="/desktop/accounts/usage">
    Credits and usage.
  </Card>

  <Card title="Terminal" icon="terminal" href="/desktop/terminal">
    An upgraded Terminal experience.
  </Card>
</CardGroup>

<CardGroup cols={2}>
  <Card title="MCP" icon="hammer" href="/desktop/cascade/mcp">
    MCP servers extend the agent's capabilities.
  </Card>

  <Card title="Memories" icon="cloud-word" href="/desktop/cascade/memories">
    Memories and rules help customize behavior.
  </Card>

  <Card title="Context Awareness" icon="brain" href="/desktop/context-awareness/windsurf-overview">
    Instantly understands your codebase.
  </Card>

  <Card title="Advanced" icon="gears" href="/desktop/advanced">
    Advanced configuration options.
  </Card>
</CardGroup>

<CardGroup cols={2}>
  <Card title="Workflows" icon="list" href="/desktop/cascade/workflows">
    Automate repetitive trajectories.
  </Card>

  <Card title="App Deploys" icon="rocket" href="/desktop/cascade/app-deploys">
    Deploy applications in one click.
  </Card>
</CardGroup>

<Tip> See what's new with Devin Desktop in our [changelog](https://windsurf.com/changelog)! </Tip>

<Note>
  Join our [Discord](https://discord.gg/GjCYNGChrw) for support, feature requests, and bug reports!
</Note>

## Set Up

<Tabs>
  <Tab title="Mac">
    Minimum OS Version: OS X Yosemite

    <a href="https://devin.ai/download/confirmation?code=ma" target="_blank" rel="noopener noreferrer">
      <button style={{width: '170px', backgroundColor: '#317CFF', color: 'white', padding: '5px 10px', border: 'none', borderRadius: '5px', cursor: 'pointer', fontSize: '0.8rem', display: 'flex', justifyContent: 'center'}}>Download for Mac</button>
    </a>
  </Tab>

  <Tab title="Windows">
    Minimum OS Version: Windows 10

    <a href="https://devin.ai/download/confirmation?code=wu" target="_blank" rel="noopener noreferrer">
      <button style={{width: '170px', backgroundColor: '#317CFF', color: 'white', padding: '5px 10px', border: 'none', borderRadius: '5px', cursor: 'pointer', fontSize: '0.8rem', display: 'flex', justifyContent: 'center'}}>Download for Windows</button>
    </a>
  </Tab>

  <Tab title="Linux">
    Minimum Requirements: glibc >= 2.28, glibcxx >= 3.4.25 (e.g. Ubuntu 20, Debian 10, Fedora 36, RHEL 8)

    <a href="https://devin.ai/download/confirmation?code=li" target="_blank" rel="noopener noreferrer">
      <button style={{width: '170px', backgroundColor: '#317CFF', color: 'white', padding: '5px 10px', border: 'none', borderRadius: '5px', cursor: 'pointer', fontSize: '0.8rem', display: 'flex', justifyContent: 'center'}}>Download for Linux</button>
    </a>
  </Tab>
</Tabs>

## Onboarding

### 1. Select your preferred theme

<Frame>
  <img src="https://mintcdn.com/cognitionai/4XoC9qWyg6BaJ8Hm/desktop/assets/windsurf/onboarding/theme.png?fit=max&auto=format&n=4XoC9qWyg6BaJ8Hm&q=85&s=dba191128bf157ef164f151f3ae55011" width="2624" height="1824" data-path="desktop/assets/windsurf/onboarding/theme.png" />
</Frame>

Keep the "Install `devin-desktop` terminal command" option checked to launch Devin Desktop from your terminal:

```bash theme={null}
devin-desktop ~/Developer/my-project
```

You can also pick your preferred keybindings by expanding "Import Settings":

<Frame>
  <img src="https://mintcdn.com/cognitionai/4XoC9qWyg6BaJ8Hm/desktop/assets/windsurf/onboarding/keybindings.png?fit=max&auto=format&n=4XoC9qWyg6BaJ8Hm&q=85&s=1a49e15dae8b09bad135ae647d649ad6" width="2624" height="1824" data-path="desktop/assets/windsurf/onboarding/keybindings.png" />
</Frame>

### 2. Log In / Sign Up

To use Devin Desktop, you will need to log in with your Devin account. If you don't have one yet, you can sign up for free!

<Frame>
  <img src="https://mintcdn.com/cognitionai/4XoC9qWyg6BaJ8Hm/desktop/assets/windsurf/onboarding/auth.png?fit=max&auto=format&n=4XoC9qWyg6BaJ8Hm&q=85&s=fe2cbc4f639f3d0ffabae4561be1c8ba" width="2624" height="1824" data-path="desktop/assets/windsurf/onboarding/auth.png" />
</Frame>

If you're having trouble logging in, you can also log in manually by providing Devin Desktop with a Devin API key:

<Frame>
  <img src="https://mintcdn.com/cognitionai/4XoC9qWyg6BaJ8Hm/desktop/assets/windsurf/onboarding/manual_auth.png?fit=max&auto=format&n=4XoC9qWyg6BaJ8Hm&q=85&s=0a5cc1ffd601ae8c74b1e142a18009c8" width="2624" height="1824" data-path="desktop/assets/windsurf/onboarding/manual_auth.png" />
</Frame>

### 3. Start Building with Devin!

<Frame>
  <video autoPlay muted loop playsInline src="https://mintcdn.com/cognitionai/WE51TvKjsiyk1ZHl/desktop/assets/windsurf/onboarding/lets_surf.mp4?fit=max&auto=format&n=WE51TvKjsiyk1ZHl&q=85&s=b611988ac0938abfd43146ff99f313d4" data-path="desktop/assets/windsurf/onboarding/lets_surf.mp4" />
</Frame>

<Card title="Recommended Plugins" icon="puzzle-piece" href="/desktop/recommended-plugins">
  Explore some of our recommended plugins to get the most out of Devin Desktop!
</Card>

## 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. :)

<AccordionGroup>
  <Accordion title="Chat with the agent">
    <Frame>
      <img src="https://mintcdn.com/cognitionai/hxeMffzXgF_RWx-U/desktop/assets/windsurf/cascade.png?fit=max&auto=format&n=hxeMffzXgF_RWx-U&q=85&s=94b2f2b782478236239898fe09e6fc2a" width="2062" height="1548" data-path="desktop/assets/windsurf/cascade.png" />
    </Frame>

    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).
  </Accordion>

  <Accordion title="Generate a project with the agent">
    <Frame>
      <img src="https://mintcdn.com/cognitionai/WE51TvKjsiyk1ZHl/desktop/assets/windsurf/cascade_generate.png?fit=max&auto=format&n=WE51TvKjsiyk1ZHl&q=85&s=8fed81769d147a5d925744ff70353253" width="2062" height="1548" data-path="desktop/assets/windsurf/cascade_generate.png" />
    </Frame>

    You can create brand new projects with the agent! Click the "New Project" button to get started.
  </Accordion>

  <Accordion title="Open Folder / Connect to Remote Server">
    <Frame>
      <img src="https://mintcdn.com/cognitionai/WE51TvKjsiyk1ZHl/desktop/assets/windsurf/open_workspace.png?fit=max&auto=format&n=WE51TvKjsiyk1ZHl&q=85&s=9f9bbb3b8c9daa61a11fa1a037b32521" width="2062" height="1548" data-path="desktop/assets/windsurf/open_workspace.png" />
    </Frame>

    You can open a folder or connect to a remote server via SSH or a local dev container. Learn more [here](/desktop/advanced).
  </Accordion>

  <Accordion title="Configure Devin Settings">
    <Frame>
      <img style={{width: '50%', display: 'block', margin: 'auto'}} src="https://mintcdn.com/cognitionai/WE51TvKjsiyk1ZHl/desktop/assets/windsurf/windsurf-settings-panel.png?fit=max&auto=format&n=WE51TvKjsiyk1ZHl&q=85&s=c4e113e7b7d284ea3e870e5b4493bc1f" width="754" height="986" data-path="desktop/assets/windsurf/windsurf-settings-panel.png" />
    </Frame>

    Click on the "Devin - 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 "Devin Settings" in the top right profile dropdown.
  </Accordion>

  <Accordion title="Open Command Palette">
    <Frame>
      <img src="https://mintcdn.com/cognitionai/WE51TvKjsiyk1ZHl/desktop/assets/windsurf/command_palette.png?fit=max&auto=format&n=WE51TvKjsiyk1ZHl&q=85&s=0bc48cef693610dbd10b6eb0f1cd41f9" width="2058" height="1544" data-path="desktop/assets/windsurf/command_palette.png" />
    </Frame>

    You can open the command palette with the `⌘+⇧+P` (on Mac) or `Ctrl+Shift+P` (on Windows/Linux) shortcut. Explore the available commands!
  </Accordion>
</AccordionGroup>

## 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:

<Tabs>
  <Tab title="VS Code">
    <Frame>
      <img src="https://mintcdn.com/cognitionai/-PTA3zzo2bR9Qfc8/desktop/assets/import-vscode.png?fit=max&auto=format&n=-PTA3zzo2bR9Qfc8&q=85&s=2e022a366e65eea19acfed44a85b0a60" width="1452" height="404" data-path="desktop/assets/import-vscode.png" />
    </Frame>
  </Tab>

  <Tab title="Cursor">
    <Frame>
      <img src="https://mintcdn.com/cognitionai/WE51TvKjsiyk1ZHl/desktop/assets/windsurf/import-cursor.png?fit=max&auto=format&n=WE51TvKjsiyk1ZHl&q=85&s=7e2afe42a69a258bf3ed2cf49bb7d6a9" width="1454" height="272" data-path="desktop/assets/windsurf/import-cursor.png" />
    </Frame>
  </Tab>
</Tabs>

## 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:

<Steps>
  <Step title="Close Devin Desktop">
    Ensure that Devin Desktop is not currently running before proceeding with the uninstallation.
  </Step>

  <Step title="Delete the Devin Desktop application">
    <Tabs>
      <Tab title="Mac">
        Drag the Devin Desktop application from the Applications folder to the Trash.
      </Tab>

      <Tab title="Windows">
        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.
      </Tab>

      <Tab title="Linux">
        Remove the Devin Desktop folder from the location where you installed it.
      </Tab>
    </Tabs>
  </Step>

  <Step title="Remove configuration files">
    <Tabs>
      <Tab title="Mac/Linux">
        Delete the Devin Desktop configuration folder:

        ```bash theme={null}
        rm -rf ~/.codeium/windsurf
        ```
      </Tab>

      <Tab title="Windows">
        Delete the Devin Desktop configuration folder:

        ```
        C:\Users\[YourUsername]\.codeium\windsurf
        ```
      </Tab>
    </Tabs>
  </Step>

  <Step title="Additional cleanup">
    <ul>
      <li>If you installed Devin Desktop in PATH, remove it from your system's PATH environment variable.</li>
      <li>If you installed Devin Desktop using your system's package manager or control panel, you can also use that to uninstall it.</li>
      <li>Empty your Trash or Recycle Bin to complete the uninstallation.</li>
    </ul>
  </Step>
</Steps>
