GitLab plugin for JetBrains IDEs

The GitLab Duo plugin integrates GitLab Duo with JetBrains IDEs like IntelliJ, PyCharm, GoLand, Webstorm, and Rubymine.

Install and configure the extension.

Enable experimental or beta features

Some features in the plugin are in experiment or beta status. To use them, you must opt in:

  1. Go to your IDE’s top menu bar and select Settings, or:
    • MacOS: press ⌘+,
    • Windows or Linux: press Control+Alt+S
  2. On the left sidebar, expand Tools, then select GitLab Duo.
  3. Select Enable Experiment or BETA features.
  4. To apply the changes, restart your IDE.

Integrate with 1Password CLI

Tier: Premium, Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated
History
  • Introduced in GitLab Duo 2.1 for GitLab 16.11 and later.

You can configure the plugin to use 1Password secret references for authentication, instead of hard-coding personal access tokens.

Prerequisites:

To integrate GitLab for JetBrains with the 1Password CLI:

  1. Authenticate with GitLab. Either:
  2. Open the 1Password item.

  3. Copy the secret reference.

    If you use the gitlab 1Password shell plugin, the token is stored as a password under "op://Private/GitLab Personal Access Token/token".

From the IDE:

  1. Go to your IDE’s top menu bar and select Settings.
  2. On the left sidebar, expand Tools, then select GitLab Duo.
  3. Under Authentication, select the 1Password CLI tab.
  4. Select Integrate with 1Password CLI.
  5. Optional. For Secret reference, paste the secret reference you copied from 1Password.
  6. Optional. To verify your credentials, select Verify setup.
  7. Select OK or Save.

Report issues with the plugin

You can report any issues, bugs, or feature requests in the gitlab-jetbrains-plugin issue queue. Use the Bug or Feature Proposal template.

If you encounter an error while using GitLab Duo, you can also report it with your IDE’s built-in error reporting tool:

  1. To access the tool, either:
    • When an error occurs, in the error message, select See details and submit report.
    • In the status bar, on the bottom right, select the exclamation mark.
  2. In the IDE Internal Errors dialog, describe the error.
  3. Select Report and clear all.
  4. Your browser opens a GitLab issue form, pre-populated with debug information.
  5. Follow the prompts in the issue template to fill out the description, providing as much context as you can.
  6. Select Create issue to file the bug report.