- Supported editor extensions
- Supported languages
- Use open tabs as context
- Enable open tabs as context
- View Multiple Code Suggestions
- Add additional languages for Code Suggestions
Supported extensions and languages
Code Suggestions is available in the following editor extensions and for the following languages.
Supported editor extensions
To use Code Suggestions, use one of these editor extensions:
IDE | Extension |
---|---|
Visual Studio Code (VS Code) | VS Code GitLab Workflow extension |
GitLab Web IDE (VS Code in the Cloud) | No configuration required. |
Microsoft Visual Studio (2022 for Windows) | Visual Studio GitLab extension |
JetBrains IDEs | GitLab Duo Plugin for JetBrains |
Neovim | gitlab.vim plugin
|
A GitLab Language Server is used in VS Code, Visual Studio, and Neovim. The Language Server supports faster iteration across more platforms. You can also configure it to support Code Suggestions in IDEs where GitLab doesn’t provide official support.
You can express interest in other IDE extension support in this issue.
Supported languages
Code Suggestions is aware of common popular programming languages, concepts, and infrastructure-as-code interfaces, like Kubernetes Resource Model (KRM), Google Cloud CLI, and Terraform.
Code Suggestions supports these languages:
Language | Web IDE | VS Code | JetBrains IDEs | Visual Studio 2022 for Windows | Neovim |
---|---|---|---|---|---|
C | Yes | Yes | No | Yes | Yes |
C++ | Yes | Yes | Yes | Yes | Yes |
C# | Yes | Yes | Yes | Yes | Yes |
CSS | Yes | No | No | No | No |
Go | Yes | Yes | Yes | Yes | Yes |
Google SQL | Yes | Yes | Yes | Yes | Yes |
HAML | Yes | Yes | Yes | Yes | Yes |
HTML | Yes | No | No | No | No |
Java | Yes | Yes | Yes | Yes | Yes |
JavaScript | Yes | Yes | Yes | Yes | Yes |
Kotlin | No |
Yes (Requires third-party extension providing Kotlin support) | Yes | Yes | Yes |
Markdown | Yes | No | No | No | No |
PHP | Yes | Yes | Yes | Yes | Yes |
Python | Yes | Yes | Yes | Yes | Yes |
Ruby | Yes | Yes | Yes | Yes | Yes |
Rust | Yes | Yes | Yes | Yes | Yes |
Scala | No |
Yes (Requires third-party extension providing Scala support) | Yes | Yes | Yes |
Shell scripts (bash only)
| Yes | No | Yes | Yes | Yes |
Svelte | Yes | Yes | Yes | Yes | Yes |
Swift | Yes | Yes | Yes | Yes | Yes |
TypeScript | Yes | Yes | Yes | Yes | Yes |
Terraform | No |
Yes (Requires third-party extension providing Terraform support) | Yes | No |
Yes (Requires third-party extension providing the terraform file type)
|
Vue | Yes | Yes | Yes | Yes | Yes |
For languages not listed in the table, Code Suggestions might not function as expected.
Use open tabs as context
- Introduced in GitLab 17.2.
To enhance the accuracy and relevance of GitLab Duo Code Suggestions, enable the use of open tabs as context in your IDE settings. This feature uses the contents of files most recently opened or changed in your IDE to provide more tailored code suggestions, within certain truncation limits. This extra context gives you:
- More accurate and relevant code suggestions
- Better alignment with your project’s standards and practices
- Improved context for new file creation
Open tabs as context supports these languages:
- Code Completion: All configured languages.
- Code Generation: Go, Java, JavaScript, Kotlin, Python, Ruby, Rust, TypeScript (
.ts
and.tsx
files), Vue, and YAML.
Enable open tabs as context
Prerequisites:
- Requires GitLab 17.1 or later.
- For GitLab self-managed instances, enable the
code_suggestions_context
and theadvanced_context_resolver
feature flags. - GitLab Duo Code Suggestions enabled for your project
- For Visual Studio Code, requires the GitLab Workflow extension, version 4.14.2 or later.
- Install the GitLab Workflow extension from the Visual Studio Marketplace.
- Configure the extension following the setup instructions.
- Enable the feature by toggling the
gitlab.aiAssistedCodeSuggestions.enabledSupportedLanguages
setting.
For installation instructions for JetBrains IDEs, see the GitLab JetBrains Plugin documentation.
When you’re ready to start coding:
- Open relevant files, including configuration files, to provide better context.
- Close any files you don’t want to be used as context.
View Multiple Code Suggestions
- Introduced in GitLab 17.1.
For a code completion suggestion in VS Code, multiple suggestion options might be available. To view all available suggestions:
- Hover over the code completion suggestion.
- Scroll through the alternatives. Either:
- Use keyboard shortcuts. Press Option + `]` to view the next suggestion, and Option + `[` to view the previous suggestions.
- Select the right or left arrow to see next or previous options.
- Press Tab to apply the suggestion you prefer.
Add additional languages for Code Suggestions
If your desired language isn’t enabled by default for Code Suggestions, you can add support for it locally.
Prerequisites:
- You have installed and enabled the GitLab Workflow extension for VS Code.
- You have completed the extension setup instructions, and authorized the extension to access your GitLab account.
To do this:
- Find your desired language in the list of language identifiers for VS Code. You need the Identifier for a later step.
- In VS Code, open the extension settings for GitLab Workflow:
- On the top bar, go to Code > Settings > Extensions.
- Search for GitLab Workflow in the list, and select Manage ().
- Select Extension Settings.
- In your User settings, find GitLab › Ai Assisted Code Suggestions: Additional Languages and select Add Item.
- In Item, add the language identifier, and select OK.