> For the complete documentation index, see [llms.txt](https://developer.harness.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.harness.io/open-source/use-harness-open-source/gitspaces/ides/vs-code-desktop.md).

# VS Code Desktop

This guide will walk you through the steps to install, setup and start developing in your Gitspaces using this extension.

### Before you begin <a href="#pre-requisites" id="pre-requisites"></a>

Before starting out, ensure that you have the following:

* VS Code Desktop installed ([Install VS Code Desktop](https://code.visualstudio.com/download))
* Harness Open Source Gitspaces extension installed (Refer to the steps below)
* [Remote - SSH extension](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-ssh) must be installed and enabled in VS Code Desktop

#### Installing the Harness open source Gitspaces extension <a href="#installing-the-harness-open-source-gitspaces-extension" id="installing-the-harness-open-source-gitspaces-extension"></a>

To install the “Harness Open Source Gitspaces” extension, here’s what you need to do:

1. Open VS Code and go to the Extensions marketplace.
2. Search for “Harness Open Source Gitspaces Extension”.

   ![](/files/nXeDZC48cdNh8yoibAaQ)
3. Once it appears, click “Install”. ![](/files/8Ence9LWMXTg8kWTvTM3)

#### Setting up the extension <a href="#setting-up-the-extension" id="setting-up-the-extension"></a>

Here’s what you have to do to setup the extension in your VS Code Desktop:

1. Once you have installed the extension, you will see the “Harness Open Source Gitspaces” logo in your sidebar.

   ![](/files/2otLXl4t2f7pMdhIdFuq)
2. To set it up, navigate to the extension settings. You need to configure the extension with a token.

   ![](/files/4nmF90DJiUWMLrFF8sFG)

   ![](/files/Pi4BJG8qOig5KYhiyfAA)
3. To create a token, go to the Harness Open Source UI and open your profile section.

   ![](/files/R36ZLB2GfB1xIxYORieq)
4. From there, create a new token by giving it a name and setting its expiration. Once created, copy the token from the provided box. *Please ensure you store this token securely, as you will not be able to view it again.*

   ![](/files/rUa5bynb8HaG5tZOQKfq) ![](/files/i34hJ5eMQ0wZF8AeEZAf)
5. Go back to VS Code Desktop and paste the token into the extension's settings tab.

   ![](/files/fczG4MuFoY5uM01445jS)
6. And that’s it, your extension is now set up.
7. To verify your account, check the Accounts icon in the activity bar; your Gitspace account should now be listed.

   ![](/files/zzu60YCvKEoE2bul5xWf)

#### Opening a Gitspace <a href="#opening-a-gitspace" id="opening-a-gitspace"></a>

Here’s how you can create and open a Gitspace in your VS Code Desktop via Harness Open Source:

1. Start by creating a Gitspace in your Harness Open Source UI.

   ![](/files/waHmK4iWnq2YppYRvh0O)
2. After the Gitspace is created, click "Open VS Code Editor" from the Harness Open Source UI.

   ![](/files/m6CSqyoW4JHbFciR6r2b)
3. You’ll be asked for permission to open VS Code Desktop. Click “Open.”

   ![](/files/s4Fpr1NTwyLBZdYjeXmn)
4. You’ll be prompted to open the Gitspace inside your VS Code IDE. Click “Open.”

   ![](/files/HAy4Hg7omaNbJTxWdhwq)
5. To establish this remote connection, a temporary password will be generated automatically. After the Gitspace is created, you'll be prompted to copy the temporary password. Paste it and follow the prompts to establish the remote connection.

   ![](/files/9MRNfp25R8FPo3Vkx1ol)
6. Once you have set it up, you’ll be able to access your Gitspace remotely inside your VS Code Desktop.

   ![](/files/yZBPFPt1D6dlIoVI1jOC)
