GitLab Extension for Visual Studio IDE

This project is the GitLab extension for Visual Studio (Community, Pro, and Enterprise). For the Visual Studio Code extension, see GitLab Workflow.

This project shows a status icon in the status bar:

1. Not configured (): If you haven't configured the extension, the extension shows an error icon with a tooltip about configuration.
2. Code Suggestions status: Either enabled () or disabled ().
3. Loading suggestion (): GitLab is generating a code suggestion for you.
4. Error (): Display an error icon and provide an error message as tooltip.

Minimum supported version

The GitLab for Visual Studio extension supports Code Suggestions for both GitLab SaaS and GitLab self-managed.

Requirements:

• Visual Studio 2022.
• GitLab version 16.1 and later.
  • GitLab Duo Code Suggestions requires GitLab version 16.8 or later.

Visual Studio for Mac is not supported.

Set up the extension

Prerequisites:

• You must be using GitLab Enterprise Edition.
• For self-managed installations, Code Suggestions must be enabled for your instance.
• For GitLab.com, Code Suggestions must be enabled for your top-level group. See instructions for SaaS.

To set up the extension:

1. Install the extension from the Visual Studio Marketplace and enable it.
2. In GitLab, create a GitLab personal access token with the api and read_user scopes:
3. Copy the token. For security reasons, this value is never displayed again, so you must copy this value now.
4. Open Visual Studio.
   1. On the top bar, go to Tools > Options > GitLab.
   2. In the Access Token field, paste in your token. The token is not displayed, nor is it accessible to others.
   3. In the GitLab URL field, provide the URL of your GitLab instance. For GitLab SaaS, use https://gitlab.com.

No new additional data is collected to enable this feature. Private non-public GitLab customer data is not used as training data. Learn more about Google Vertex AI Codey APIs Data Governance

Use Code Suggestions

Write code more efficiently by using generative AI to suggest code while you're developing. To learn more about this feature, see the Code Suggestions documentation

Prerequisites:

• Your project must use one of the supported languages:

• C++

• C#

• Go

• Google SQL

• Java

• JavaScript

• Kotlin

• PHP

• Python

• Ruby

• Rust

• Scala

• Swift

• TypeScript

To use Code Suggestions:

1. Author your code. As you type, suggestions are displayed. Code Suggestions provide code snippets or complete the current line, depending on the cursor position.
2. Describe your requirements in natural language. Code Suggestions generates functions and code snippets based on the context you provide.
3. To accept a suggestion, press Tab. To reject a suggestion, press Escape.
4. To ignore a suggestion, keep typing as you usually would.

This extension provides these custom commands:

Customize keyboard shortcuts

You can access the extension's custom commands with keyboard shortcuts, which you can customize:

1. On the top bar, go to Tools > Options.
2. Go to Environment > Keyboard. Commands exposed by this extension are prefixed with GitLab..
3. Select a command, and assign it a keyboard shortcut.

Roadmap

To learn more about this project's team, processes, and plans, see the Create:Editor Extensions Group page in the GitLab handbook.

For a list of all open issues in this project, see the issues page for this project.

Troubleshooting

See the troubleshooting documentation.

Report issues in the feedback issue.

Certificate errors

If your machine connects to your GitLab instance through a proxy with a use of self-signed certificate, you might encounter certificate errors. In such case you might need to ignore certificate errors. By design, this setting represents a security risk: these errors alert you to potential security breaches. You should enable this setting only if you are absolutely certain the problem is caused by the proxy.

To do this:

1. On the top bar, go to Tools > Options.
2. Go to GitLab > General.
3. Set Ignore certificate errors to True.
4. To apply the settings, restart your IDE.

Feedback

We'd love to hear from you. If you've found a bug, or have an idea, open an issue.

Contributing

This extension is open source and hosted on GitLab. Contributions are more than welcome and subject to the terms set forth in CONTRIBUTING. Feel free to fork and add new features or submit bug reports. See CONTRIBUTING for more information.