Code with Gemini Code Assist

VS Code

1. Before testing Gemini Code Assist capabilities in your code file, make sure your file's coding language is supported. For more information on supported coding languages, see Supported coding languages.

2. If you prefer to use your IDE behind a proxy, see Network Connections in Visual Studio Code.

IntelliJ

1. Before testing Gemini Code Assist capabilities in your code file, make sure your file's coding language is supported. For more information on supported coding languages, see Supported coding languages.

2. If you prefer to use your IDE behind a proxy, see HTTP Proxy.

VS Code

1. To open the Extensions view in VS Code, click Extensions or press Ctrl/Cmd+Shift+X.

2. Search for Gemini Code Assist.

3. Click Install.

4. If prompted, restart VS Code.

   After the extension has successfully installed, Gemini Code Assist appears in the activity bar and is ready for use. You can further configure your Gemini Code Assist installation by specifying your preferences using the top-level application taskbar: navigate to Code > Settings > Settings > Extensions and search for Gemini Code Assist.

IntelliJ

1. Click settings IDE and Project Settings > Plugins.
2. In the Marketplace tab, search for Gemini Code Assist.
3. Click Install to install the plugin.
4. When the installation is finished, click Restart IDE.

5. When the IDE restarts, Gemini Code Assist appears in your activity bar.

   

VS Code

If you select a Google Cloud project without the Gemini for Google Cloud API enabled, you receive a notification that gives you the option to enable the API from the IDE. Select Enable the API in the notification window to enable the API for your project. For more information, see Set up Gemini Code Assist for a project.

If you prefer to follow the Code with Gemini Code Assist walkthrough directly in your IDE, click Launch VS Code and follow the steps in the walkthrough to connect to Google Cloud and activate Gemini Code Assist.

Launch VS Code

Otherwise, follow these steps:

1. Launch your IDE.

2. In the activity bar, click Gemini Code Assist.

3. In the Gemini Code Assist chat pane, click Login to Google Cloud.

4. When prompted to allow Gemini Code Assist to open the external website, click Open.

5. Follow the prompts to sign into your Google Account.

6. When asked if you downloaded Gemini Code Assist from Google, click Sign In.

   You're now connected to Google Cloud.

   Next, to select a Google Cloud project that has the Gemini for Google Cloud API enabled, follow these steps:

7. In the Gemini Code Assist status bar, click Gemini Code Assist.

   

8. In the Gemini Code Assist menu, select Select Gemini Code project.

9. Select a Google Cloud project that has the Gemini for Google Cloud API enabled.

   Gemini Code Assist is ready to use.

   

IntelliJ

To sign in to your Google Account, follow these steps:

1. In the activity bar, click spark Gemini Code Assist.

2. Click Log in to Google.

3. On the page that opens in the web browser, select your Google Account.

4. On the screen that asks you to make sure that you downloaded this app from Google, click Sign in.

   Gemini Code Assist is now authorized to access your account.

   Next, if this is your first time using Gemini in your IDE, you must select a Google Cloud project by following these steps:

5. Return to your IDE. In the Gemini Code Assist tool window, if you agree to allow Google to enable the APIs required to use Gemini Code Assist on your behalf for your selected project, click Select a GCP project to continue.

6. In the Select Google Cloud Project dialog, search for and select your Google Cloud project, and then click OK.

7. Click FINISH.

VS Code

To get an explanation of your code, follow these steps:

1. Open your code file.

2. In the activity bar of your IDE, click spark Gemini Code Assist.

3. In the Gemini Code Assist pane, enter the prompt Explain this code to me and click send Send.

   Gemini uses the code in your code file as a reference to your prompt and responds with an explanation of your code.

   To refer to a specific block of code instead of all the code in the file, you can select the block in your code file and then prompt Gemini.

IntelliJ

To get an explanation of your code, follow these steps:

1. In your IDE, open your code file.

2. In the Gemini Code Assist tool window, enter the prompt Explain this code to me and click Submit.

Gemini Code Assist uses the code in your code file as a reference to your prompt and responds with an explanation of your code.

If you only want an explanation of a certain part of your code, you can select certain code and then prompt Gemini Code Assist again. Gemini Code Assist will only use the selected code as a reference to its generated response.

When Gemini Code Assist provides you with code in its response, you can select the following options listed at the end of its response:

• Insert at Cursor: Inserts the generated code into your current file at your current cursor position.

• Insert in New File: Opens a new file and inserts the generated code into the new file.

  

These options are available when Gemini Code Assist identifies the language used in your code block, and if this language is supported in your current IDE.

View query history

If you want to re-use your previous prompts, you can find them in your Query History in the Gemini Code Assist tool window by clicking schedule Show Query History.

VS Code

In the Gemini Code Assist pane, click delete Reset Chat.

IntelliJ

In the Gemini Code Assist tool window, click delete Clear Conversation History. This also clears your query history.

VS Code

Prompt Gemini Code Assist with code transformation

Code transformation allows you to use commands or natural language prompts in the Quick Pick menu to request modifications to your code, and provides you with a diff view to show pending changes to your code. To prompt Gemini Code Assist with code transformation, follow these steps:

1. In your code file, on a new line, press Control+I (for Windows and Linux) or Command+I (for macOS) to open the Gemini Code Assist Quick Pick bar.

2. In the menu, using the /generate command, enter /generate function to create a Cloud Storage bucket and then press Enter (for Windows and Linux) or Return (for macOS).

   

   Gemini Code Assist generates the code based on your prompt in a diff view.

   

3. Optional: To accept these changes, click Accept.

Prompt Gemini Code Assist in a code file with a comment

If you prefer, you can also prompt Gemini Code Assist in your code file with a comment by following these steps:

1. On a new line, enter the comment Function to create a Cloud Storage bucket, and then press Enter (for Windows and Linux) or Return (for macOS).

2. To generate code, press Control+Enter (for Windows and Linux) or Control+Return (for macOS).

   Next to your prompt text in your code file, Gemini Code Assist generates the code in the form of ghost text.

3. Optional: To accept the generated code, press Tab.

Prompt Gemini Code Assist with selected code using chat

Gemini Code Assist can perform tasks or answer your questions based on the code that you select. To get generated code that's based on a prompt with selected code, follow these steps:

1. In the activity bar, click spark Gemini Code Assist to open the Gemini Code Assist pane.

2. In your code file, select a block of code.

3. In the Gemini Code Assist pane text field, enter a prompt for the selected code.

   For example, select a function in your code and enter the prompt Write a unit test for this function:

   

   Gemini uses your selected code as reference and responds to your prompt.

IntelliJ

Prompt Gemini Code Assist with code transformation

Code transformation allows you to use commands or natural language prompts in the Quick Pick menu to request modifications to your code, and provides you with a diff view to show pending changes to your code. To prompt Gemini Code Assist with code transformation, follow these steps:

1. In your code file, on a new line, press Alt+\ (for Windows and Linux) or Cmd+\ (for macOS) to open the Gemini Code Assist Quick Pick menu.

2. In the menu, using the /generate command, enter /generate function to create a Cloud Storage bucket and then press Enter (for Windows and Linux) or Return (for macOS).

   

   Gemini Code Assist generates the code based on your prompt in a diff view.

   

3. Optional: To accept these changes, click Accept Changes.

   You can use the following code transformation commands in your IDE:

   • /fix: Fix issues or errors in your code. Example: /fix potential NullPointerExceptions in my code.
   • /generate: Generate code. Example: /generate a function to get the current time.
   • /doc: Add documentation to your code. Example: /doc this function.
   • /simplify: Simplify your code. Example: /simplify if statement in this code.

Prompt Gemini Code Assist in a code file with a comment

1. In your code file, on a new line, enter the comment Function to create a Cloud Storage bucket.

2. To generate code, press Alt+G (for Windows and Linux) or Option+G (for macOS). Alternatively, you can right-click next to the comment and select Generate Code.

   Gemini Code Assist generates the code below your comment in the form of ghost text.

3. Optional: To accept the generated code, press Tab.

Prompt Gemini Code Assist with selected code using chat

Gemini Code Assist can perform tasks or answer your questions based on the code that you select. To get generated code that's based on a prompt with selected code, follow these steps:

1. In the activity bar, click spark Gemini Code Assist to open the Gemini Code Assist tool window.

2. In your code file, select a block of code.

3. In the Gemini Code Assist tool window text field, enter a prompt for the selected code.

   For example, select a function in your code and enter the prompt Write a unit test for this function.

   Gemini Code Assist uses your selected code as reference and responds to your prompt.

VS Code

1. In your IDE, click File (for Windows and Linux) or Code (for macOS), and then navigate to Settings > Keyboard Shortcuts.

2. In the list of keyboard shortcuts, scroll until you find Gemini Code Assist: Generate code.

3. Click Gemini Code Assist: Generate Code, and then click edit Change Keybinding.

4. In the dialog that appears, enter your own shortcut.

5. Press Enter (for Windows and Linux) or Return (for macOS).

   You can now use your newly assigned keyboard shortcut to generate code with Gemini Code Assist.

To learn more about changing shortcuts in your IDE, see Keybindings for Visual Studio Code.

IntelliJ

1. Navigate to settings IDE and Project Settings > Settings > Keymap > Gemini Code Assist.

2. Right-click Gemini Code Assist and select Add Keyboard Shortcut.

3. Enter your preferred keyboard shortcut and then click OK.

4. Right-click Gemini Code Assist and select Remove Alt+G (for Windows and Linux), or Remove Option+G (for macOS).

You can now use your new keyboard shortcut to generate code in a code file.

VS Code

1. In your code file, on a new line, start writing a function. For example, if you're in a Python file, write def.

   Gemini Code Assist suggests code in the form of ghost text.

2. To accept the code suggestion from Gemini Code Assist, press Tab. Otherwise, to ignore the suggestion, press Esc or continue writing your code.

IntelliJ

1. In your code file, on a new line, start writing a function. For example, if you're in a Python file, write def.

   Gemini Code Assist suggests code in the form of an inline suggestion.

2. To accept the code suggestion from Gemini Code Assist, press Tab. Otherwise, to ignore the suggestion, press Esc or continue writing your code.

3. Optional: If you prefer to use a different shortcut key to accept the inline suggestion, hold your pointer over the inline suggestion and click the Tab dropdown that appears. Then, select your preferred shortcut or click Custom to enter your own shortcut.

   

VS Code

1. In your IDE, click Code (for macOS) or File (for Windows and Linux), and then navigate to Settings > Settings.

2. On the User tab of the Settings dialog, navigate to Extensions > Gemini Code Assist.

3. Scroll until you find the Duet AI: Inline Suggestions: Enable Auto list, and then select Off.

   This turns off the inline suggestions. You can still press Control+Enter (for Windows and Linux) or Control+Return (for macOS) to manually trigger inline suggestions.

IntelliJ

In the status bar of your IDE, click spark Gemini Code Assist: Active and select Enable AI Code Completion.

This disables the code completion setting, and Gemini Code Assist no longer makes inline suggestions until you enable the setting again.

VS Code

1. In your code file, select a block of code.

2. Next to the selected code block, click lightbulb Show Code Actions.

   

3. Select an action such as Generate unit tests.

   Gemini generates a response that's based on the action you selected.

IntelliJ

1. In your code file, select a line or block of code.

2. Right-click the selected code and select a smart action, like Generate unit tests.

   Selecting the smart action will automatically prompt Gemini Code Assist to generate a response to the prompt in the Gemini Code Assist tool window.

VS Code

1. In your code file, hold your pointer over the squiggly error line and select Quick Fix, and then select /fix.

   

2. When the quick fix is applied, a diff view appears. To accept these changes, click Accept.

IntelliJ

1. In your code file, click the red error bulb icon, which indicates an error in your code, and select Fix with Gemini.

   

2. When the fix is applied, a diff view appears. To accept these changes, click Accept.

VS Code

• Chat responses may be truncated when they include an updated version of a large open file

  To work around this issue, select a smaller section of code and include an additional directive in the chat prompt, such as only output the selected code.

• Vim: Cannot accept or dismiss code generation suggestions unless in insert mode

  When using the Vim plugin in normal mode, you can't accept or dismiss code suggestions.

  To work around this issue, press i to enter insert mode, and then press Tab to accept the suggestion.

• Vim: Inconsistent behavior when pressing Esc to dismiss suggestions

  When you press Esc, both the IDE and Gemini suggestions are dismissed. This behavior is different from the non-Vim behavior where pressing Esc re-triggers Gemini.

• Sign-in attempts keep timing out

  If your sign-in attempts keep timing out, try adding the cloudcode.beta.forceOobLogin setting to your settings.json file:

   "cloudcode.beta.forceOobLogin": true
  

• License recitation warnings don't persist across sessions

  If license recitation warnings don't persist across sessions, refer to the persistent logs:

  1. Click View > Output.

  2. Select Gemini Code Assist - Citations.

• Connectivity issues in the Gemini Code Assist output window

  If you see a connection error or other connectivity problems in the Gemini Code Assist output window, try the following:

  • Configure your firewall to allow access to oauth2.googleapis.com and cloudaicompanion.googleapis.com.

  • Configure your firewall to allow communication over HTTP/2, which gRPC uses.

  You can use the grpc-health-probe tool to test connectivity. A successful check results in the following output:

  $ grpc-health-probe -addr cloudaicompanion.googleapis.com:443 -tls error: this server does not implement the grpc health protocol (grpc.health.v1.Health): GRPC target method can't be resolved

  An unsuccessful check results in the following output:

  timeout: failed to connect service "cloudaicompanion.googleapis.com:443" within 1s

  To obtain more details, run the following before grpc-health-probe:

  export GRPC_GO_LOG_SEVERITY_LEVEL=info
  

• 'Activate Gemini Code Assist' still appears after selecting Gemini Code Assist project

  If you selected your project per the instructions in this guide, which includes enabling the Gemini for Google Cloud API, then there may be an issue with the LS server.

  To find out more details about your issue, perform the following actions:

  1. In the status bar, click spark Gemini Code Assist and then select Send feedback.

  2. Click Show for any of the log files to see more details and to help troubleshoot the issue.

IntelliJ

There are no known issues for Gemini Code Assist for IntelliJ and other supported JetBrains IDEs.

VS Code

1. In the status bar, click spark Gemini Code Assist, and then in the Quick Pick menu, select Send feedback.

2. In the form, fill out the Title and Comments fields.

3. If you want to share your Skaffold or AI Companion logs, make sure that you select the Send Skaffold logs or Send AI Companion logs option.

4. Click Submit Feedback.

IntelliJ

1. In the status bar, click spark Gemini Code Assist, and then in the menu, select Submit feedback.

2. In the text field at the top of the form, enter your feedback.

3. If you want to share your Gemini Code Assist logs, make sure that you select the log files.

4. Click Submit Feedback.