---
metadata:
- name: generator
content: Diplodoc Platform v5.63.0
alternate:
- https://vibe.sourcecraft.dev/portal/docs/en/code-assistant/index.md
- https://vibe.sourcecraft.dev/portal/docs/ru/code-assistant/index.md
- href: https://vibe.sourcecraft.dev/portal/docs/en/code-assistant/index.md
type: text/markdown
title: Markdown version
- href: https://vibe.sourcecraft.dev/portal/docs/en/code-assistant/llms.txt
rel: describedby
title: Getting started with SourceCraft Code Assistant
description: Install the Code Assistant plugin for Visual Studio Code, VSCodium, and JetBrains IDE.
---
> **Documentation Index:** Fetch the complete configuration index at https://vibe.sourcecraft.dev/portal/docs/en/llms.txt
# Getting started with SourceCraft Code Assistant
{% note warning %}
SourceCraft uses the capabilities of AI models within Yandex. For this to work, some of your [organization's](https://vibe.sourcecraft.dev/portal/docs/en/sourcecraft/concepts/index.md#org) data needs to be sent to Yandex. For more information, see the [terms of use](https://yandex.com/legal/cloud_terms_code_assistant).
{% endnote %}
Code Assistant is an AI-driven developer assistant based on [large language models (LLM)s](https://en.wikipedia.org/wiki/Large_language_model). With Code Assistant, you can optimize the code writing process and increase your performance.
The [smart autocompletion](https://vibe.sourcecraft.dev/portal/docs/en/code-assistant/concepts/index.md#autocompletion) mode enables the AI assistant to analyze the code context and come up with the most relevant suggestions for functions, cycles, conditions, and other elements.
Code Assistant also features a [chat mode](https://vibe.sourcecraft.dev/portal/docs/en/code-assistant/concepts/index.md#chat) you can use to interact with the AI assistant in the SourceCraft interface, your IDE, or [SourceCraft CLI with built-in OpenCode](https://vibe.sourcecraft.dev/portal/docs/en/sourcecraft/operations/cli-quickstart.md).
[SourceCraft Code Assistant terms of use](https://yandex.com/legal/cloud_terms_code_assistant/)
{% note warning %}
The Code Assistant plugin is now available for [Visual Studio Code](https://code.visualstudio.com/), [VSCodium](https://vscodium.com/), and [JetBrains IDE](https://www.jetbrains.com/ides/) versions 2026.2, 2026.1, 2025.3, 2025.2, 2025.1, 2024.3, 2024.2, and 2024.1. {#supported-versions}
{% endnote %}
To get started:
1. [Get ready to work](#before-you-begin).
1. [Install and configure the plugin](#install-plugin).
1. [Test the plugin](#work-with-plugin).
1. [Manage the plugin](#manage-plugin).
## Getting started {#before-you-begin}
[Sign up](https://vibe.sourcecraft.dev/portal/docs/en/sourcecraft/security/registration.md) for SourceCraft.
## Install and configure the plugin {#install-plugin}
{% list tabs group=ide %}
- Visual Studio Code {#vscode}
1. Download the Code Assistant plugin for [Visual Studio Code](https://code.visualstudio.com/).
If you cannot download it for any reason, contact your system administrator so that they open network access to SourceCraft resources.
1. Install the plugin:
1. Open Visual Studio Code.
1. Open **Command Palette** by pressing **Ctrl** + **Shift** + **P** for Windows or Linux or **Command** + **Shift** + **P** for macOS.
1. Enter `Extensions: Install from VSIX...` and select the plugin file you downloaded before.
The installation process will finish saying `Completed installing extension`.
You can also install Code Assistant through the [Visual Studio Code CLI](https://code.visualstudio.com/docs/editor/command-line) using this command:
```bash
code --install-extension
```
1. To get started with Code Assistant, get authenticated in SourceCraft:
1. In the **No active session found. Log in please** pop-up window, click **Go to browser**.
To re-authenticate in the plugin or log in as a different SourceCraft user, enter `>SourceCraft Code Assistant` in the top search bar. From the list that opens, select **SourceCraft Code Assistant: Login**.
1. Allow Visual Studio Code to open the authentication page in your browser.
1. In your browser, go to the SourceCraft [home page](https://sourcecraft.dev) and click **Open app** in the pop-up window.
1. Go back to Visual Studio Code.
If the plugin is enabled and ready to go, you will see  in the editor's bottom panel.
Click this icon to view the username of the SourceCraft account authenticated in the plugin. You can find the username in the **Logged in as ** row of the list. If no user is authenticated, this row will be missing.
- JetBrains IDE {#jb}
{% note info %}
If you previously installed SourceCraft Code Assistant plugin for the JetBrains IDE from a downloadable ZIP archive, [uninstall the plugin](#remove-plugin) and reinstall it using the guide below.
{% endnote %}
1. Install the plugin:
1. In the JetBrains IDE interface, click  in the upper right corner and select **Plugins...**.
1. At the top of the plugin settings window that opens, click  and select **Manage Plugin Repositories...**.
1. In the window that opens, click , enter `https://proxy.src.yandexcloud.net/proxy/plugin/jetbrains/stable` in the field that appears, and click **OK**.
1. At the top of the settings window, go to the **Marketplace** tab and select the `SourceCraft Code Assistant` plugin. If required, use the search bar.
1. Click **Install**.
1. After installation is complete, click **OK**.
If the plugin is installed successfully, you will see the **Code Assist plugin started** message in the IDE notification area.
1. Restart the IDE.
1. Enable automatic updates of the SourceCraft Code Assistant plugin: {#jb-auto-update}
1. In the JetBrains IDE interface, click  in the upper right corner and select **Settings...**.
1. Go to **Appearance & Behavior** → **System Settings** → **Updates** and enable **Update plugins automatically**.
1. Click **OK**.
1. To get started with Code Assistant, get authenticated in SourceCraft:
1. In the **SourceCraft Code Assistant OAuth** pop-up window, click **SourceCraft Code Assistant: Login**.
To re-authenticate in the plugin or log in as a different SourceCraft user, click  in the top right corner of the editor, enter `SourceCraft Code Assistant` in the window that opens, and select **SourceCraft Code Assistant: Login**.
1. In your browser, open the SourceCraft [home page](https://sourcecraft.dev) page.
1. Go back to the IDE.
If the plugin is enabled and ready to go, you will see  in the editor's bottom panel.
Click this icon to view the username of the SourceCraft account authenticated in the plugin. You can find the username in the **Logged in as ** line of the message you get. If no user is authenticated, the message will display **No Auth data**.
{% note tip %}
If the plugin failed to start, or you do not see suggestions from Code Assistant, try restarting the IDE.
{% endnote %}
{% endlist %}
## Test the plugin {#work-with-plugin}
{% note info %}
To work with Code Assistant, you will need continuous internet access.
{% endnote %}
The smart autocompletion mode explicitly supports code autocompletion for the following programming languages and frameworks:
* C++
* Go
* Java
* JavaScript/TypeScript
* Kotlin
* Python
* Scala
* SQL
* Swift
Autocompletion may also work for other languages. For languages that are less represented in public repositories, the number and quality of autocompletion prompts will be lower.
## Use case {#examples}
In this example, we use the [_insert_](#insert) mode to revise the code, and then, the [_replace_](#replace) mode, which provides suggestions for the next lines based on the edits we made:
Here, after we have changed the argument name, the _replace_ mode updates it accordingly in the other lines:
## Insert mode {#insert}
The _insert_ mode in Code Assistant can suggest the most suitable options to complete the current line or word.
Code Assistant analyzes your code context and provides the following types of suggestions:
* Automatic.
* User-triggered (**Ctrl** + **Space**). In Visual Studio Code, you can also use **Ctrl** + **Enter**.
1. Open the IDE and create a test file named `server.cpp` with the following contents:
```cpp
// simple web-server to work with sockets
#include
#include
#include
#include
#include
using namespace std;
int main() {
}
```
1. In the `int main()` section, start typing something, e.g., `//create socket`. See the Code Assistant suggestion:
```cpp
...
int main() {
//create socket
int sockfd = socket(AF_INET, SOCK_STREAM, 0);
}
```
1. Select an action for the suggestion:
{% list tabs group=ide %}
- Visual Studio Code {#vscode}
* Click **Tab** to accept the suggestion.
* To start accepting the suggestion word by word, press **Ctrl** + **→** for Windows or Linux or **Command** + **→** for macOS.
* To discard the suggestion, press **Esc**.
* If there are multiple suggestions, you can switch between them using **Alt** + **[** and **Alt** + **]** for Windows or Linux or **Option** + **[** and **Option** + **]** for macOS.
- JetBrains IDE {#jb}
* Click **Tab** to accept the suggestion.
* To discard the suggestion, press **Esc**.
{% endlist %}
You can also watch our Code Assistant video tutorial [here](https://sourcecraft.dev/portal/code-assistant/).
## Replace mode {#replace}
The _replace_ mode in Code Assistant can suggest corrections and renaming options in the current file code based on the changes you have made.
1. Open the IDE and create a test file named `fibonacci.py` with the following contents:
```py
def fibonacci(k):
if k == 0:
return 0
elif k == 1:
return 1
else:
return fibonacci(k-1) + fibonacci(k-2)
print(fibonacci(10))
```
1. For example, change the variable name from `k` to `n`. See the Code Assistant corrections:
```py
def fibonacci(n):
if n == 0:
return 0
elif n == 1:
return 1
else:
return fibonacci(n-1) + fibonacci(n-2)
print(fibonacci(10))
```
Code Assistant suggests corrections line by line. Move the cursor to the relevant line to see a correction from Code Assistant.
1. Select what to do with the suggestion:
* Click **Tab** to accept the suggestion.
* To discard the suggestion, press **Esc**.
The model takes code revision history into account. Depending on this history, the suggestions may vary significantly.
Also test [quick actions](https://vibe.sourcecraft.dev/portal/docs/en/code-assistant/operations/quick-actions.md) and the plugin's performance in [agent mode](https://vibe.sourcecraft.dev/portal/docs/en/code-assistant/operations/agent/chat-interface.md) in Visual Studio Code or [chat mode](https://vibe.sourcecraft.dev/portal/docs/en/code-assistant/operations/chat.md) in the JetBRains IDE.
### Suggestion indicator {#help-indicator}
When generating a suggestion, the  loading icon will appear to the left of the editable code. If generation stops or there is no result, you will see the  (no suggestion) icon.
The suggestion indicator is enabled by default.
To enable or disable the indicator:
{% list tabs group=ide %}
- Visual Studio Code {#vscode}
1. In the left-hand panel, click .
1. In the panel that opens, select  **Settings**.
1. Navigate to **Autocompletion**.
1. In the settings window that opens, enable or disable the **Code Assistant suggestion indicator** and **Code Assistant load indicator**.
- JetBrains IDE {#jb}
1. In the top-right corner, click  and select **Settings...**.
1. In the left-hand column, select **SourceCraft Code Assistant**.
1. Enable or disable **Disable suggest indicator**.
1. To save the settings, click **Apply**.
{% endlist %}
## Manage the plugin {#manage-plugin}
### Enable or disable auto suggestions {#enable-disable-plugin}
You can enable or disable auto suggestions only in Visual Studio Code.
{% list tabs group=ide %}
- Visual Studio Code {#vscode}
1. Click  in the Visual Studio Code bottom panel.
1. In the list that opens, select  **Enable SourceCraft Code Assistant autocomplete** or  **Disable SourceCraft Code Assistant autocomplete**.
{% endlist %}
### Update the plugin {#update-plugin}
{% list tabs group=ide %}
- Visual Studio Code {#vscode}
Once you run the plugin, it will automatically check for an update and install it.
To force an update, in the editor’s bottom panel, click  and select **Check For Updates** from the list that opens.
- JetBrains IDE {#jb}
Once you run the plugin, it will automatically check for an update.
If you did not [set up automatic plugin updates](#jb-auto-update), you can update it manually:
1. In the top-right corner, click  and select **Plugins...**.
1. Select **SourceCraft Code Assistant**.
1. If an update is available for the plugin, you will see the **Update** button. Click it.
{% endlist %}
### Log out of the SourceCraft profile {#logout}
To log out of your SourceCraft profile in the Code Assistant plugin:
{% list tabs group=ide %}
- Visual Studio Code {#vscode}
In Visual Studio Code, there are two ways to log out of your profile:
* In the editor’s bottom panel, click  and select **Logout** from the list that opens.
* In the top search bar, enter `>SourceCraft Code Assistant`. From the list that appears, select **SourceCraft Code Assistant: Logout**.
- JetBrains IDE {#jb}
In the top right corner of the editor, click , enter `SourceCraft Code Assistant` in the window that opens, and select **SourceCraft Code Assistant: Logout**.
{% endlist %}
To re-authenticate in the plugin, follow the instructions described in step 3 of [Install and configure the plugin](#install-plugin).
### Remove the plugin {#remove-plugin}
{% list tabs group=ide %}
- Visual Studio Code {#vscode}
1. Open the list of installed plugins by pressing **Ctrl** + **Shift** + **X** for Windows or Linux or **Command** + **Shift** + **X** for macOS.
1. In the SourceCraft Code Assistant row, click  and select **Uninstall**.
- JetBrains IDE {#jb}
1. Open settings by pressing **Ctrl** + **Alt** + **S** for Windows or Linux or **Command** + **,** for macOS.
1. Go to the **Plugins** section and select the SourceCraft Code Assistant plugin.
1. In the plugin description section, click  and select **Uninstall**.
1. Confirm deletion and click **OK**.
{% endlist %}
#### Useful links {#see-also}
* [Code Assistant overview](https://vibe.sourcecraft.dev/portal/docs/en/code-assistant/concepts/index.md)
* [SourceCraft Code Assistant chat interface in the JetBrains IDE](https://vibe.sourcecraft.dev/portal/docs/en/code-assistant/operations/chat.md)
* [Quick actions in SourceCraft Code Assistant](https://vibe.sourcecraft.dev/portal/docs/en/code-assistant/operations/quick-actions.md)
#|
|| _The SourceCraft Code Assistant plugin for Visual Studio Code uses [Roo Code](https://roocode.com/)._
_Copyright 2025 Roo Code, Inc._
_[Apache-2.0 license](https://github.com/RooCodeInc/Roo-Code?tab=Apache-2.0-1-ov-file)_
_[Modified files](https://vibe.sourcecraft.dev/portal/docs/en/code-assistant/roo-modified-files.md)_ ||
|#
_Project by Yandex© 2026 Yandex.Cloud LLC_