Code with Gemini Code Assist

This document describes how you can useGemini Code Assist, an AI-poweredcollaborator in Google Cloud, to help you do the following in Cloud Shell:

  • Provide guidance to help you solve problems with your code.

  • Generate code for your project.

  • Receive inline suggestions while you're coding.

Learnhow and when Gemini for Google Cloud uses your data.

To help youcomply with any license requirements for your code,Gemini Code Assist provides source citations when its suggestionsdirectly quote at length from a specific source. To learn more about how andwhen Gemini cites sources, seeHow Gemini helps you generate code and cites sources.

Code customizationlets you get code suggestions based on your organization's private codebasedirectly from Gemini Code Assist. Learnhow to configure code customization.

This document is intended for developers of all skill levels. It assumes youhave working knowledge of the Cloud Shell Editor and are familiar with Google Cloud.If you prefer, you can also explore Gemini Code Assist inCloud Workstations,IntelliJ, andVS Code.

Connect to Google Cloud and select a project

In this section, you'll connect to Google Cloud and select aGoogle Cloud project with the Gemini for Google Cloud API enabled inthe Cloud Shell Editor.

If you select a Google Cloud project without theGemini for Google Cloud API enabled, you receive a notification that gives youthe option to enable the API from the IDE. SelectEnable the API in thenotification window to enable the API for your project. For more information,seeSet up Gemini Code Assist for a project.

Note: There are multiple places where you can set a Google Cloud project in Cloud Shell Editor, such as in the terminal or in the footer menu. To connect to Google Cloud and select a project in Cloud Shell Editor with Gemini Code Assist, you must use the dropdown menu next to the search bar, as described in the following steps. The project you select in this menu is used to check for a Gemini Code Assist subscription and determines your quota; it may also impact settings that apply to your Gemini usage, such as whether logging is enabled.

To connect to Google Cloud inthe Cloud Shell Editor,follow these steps:

  1. Launch theCloud Shell Editor.

  2. If prompted to authorize Cloud Shell Editor to make Google CloudAPI calls, clickAuthorize.

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

  4. Next to the search bar, click thekeyboard_arrow_downGemini CodeAssist dropdown menu.

    Gemini Code Assist dropdown menu.

  5. From the menu, selectSelect Gemini Code Assist Project. This opens theSelect Google Cloud project menu.

  6. From theSelect Google Cloud project menu, select a Google Cloudproject that has the Gemini for Google Cloud API enabled.

    You're now connected to Google Cloud. Gemini is ready touse.

Chat with Gemini Code Assist

As an early-stage technology, Gemini for Google Cloud products can generate output that seems plausible but is factually incorrect. We recommend that you validate all output from Gemini for Google Cloud products before you use it. For more information, seeGemini for Google Cloud and responsible AI.

In this section, learn how to open theGemini Code Assist pane andchat with Gemini Code Assist to get your code explained.

To begin chatting with Gemini, follow these steps:

  1. Open a source file.

  2. Next to the search bar in Cloud Shell Editor, clickchat_sparkOpen GeminiCode Assist Chat.

  3. In theGemini Code Assist Chat pane, enter the promptExplain this codeto me and clicksendSend.

    Gemini uses your file as context foryour prompt and responds with an explanation of your code.

    To focus on a specific block of code, select that block in your open filebefore entering your prompt.

Reset chat history

Gemini Code Assist uses the chat history for additional contextwhen responding to your prompts.

If your chat history is no longer relevant to what you're trying to achieve, youcan reset the chat history: in theGemini Code Assist pane, clickdeleteReset Chat.

Note: The chat history automatically resets when you switch the workspace orexit the Cloud Shell Editor.

Generate code with prompts

The following sections show you how to use Gemini Code Assist togenerate code with the example promptFunction to create a Cloud Storagebucket inside a file. You can also select a part of your codeand then prompt Gemini Code Assist for help through the chatfeature, and receive and accept or reject code suggestions while you code.

Prompt Gemini Code Assist in a file

  1. In a source file, on a new line, enter the commentFunction tocreate a Cloud Storage bucket, and then pressEnter(for Windows and Linux) orReturn (for macOS).

  2. To generate code, pressControl+Enter (for Windows and Linux) orControl+Return (for macOS).

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

  3. Optional: To accept the generated code, pressTab.

Optional: Change keyboard shortcut for generating code

If the default keyboard shortcut for generating code isn't working as outlinedin the previous section, you can change the keyboard shortcut by following thesesteps:

  1. In the Cloud Shell Editor, clickmenuMenu, and then navigate toFile>Preferences>Keyboard Shortcuts.

  2. In the list of keyboard shortcuts, search forCloud Code: Generate Code.

  3. ClickCloud Code: Generate Code, and then clickeditChange Keybinding.

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

  5. PressEnter (for Windows and Linux) orReturn (formacOS).

    You can now use your newly assigned keyboard shortcut to generate code withGemini.

Prompt Gemini Code Assist with selected code using chat

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

  1. Next to the search bar inCloud Shell Editor, clickchat_sparkOpen Gemini CodeAssist Chat.

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

  3. In theGemini Code Assist Chat text field, enter a prompt for theselected code.

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

    Gemini uses your selected code as reference andresponds to your prompt.

Get inline suggestions while you code

While you write code, Gemini Code Assist makes inline codesuggestions that you can either accept or ignore. To try this feature, followthese steps:

  1. In a source file, on a new line, start writing a function.For example, if you're in a Python file, writedef. Geminisuggests code in the form of ghost text.

  2. To accept the code suggestion from Gemini Code Assist, pressTab. Otherwise, to ignore the suggestion, pressEsc orcontinue writing your code.

Optional: Disable inline suggestions

If you prefer to disable inline suggestions in Gemini Code Assist,follow these steps:

  1. In the Cloud Shell Editor, selectmenuMenu, and thennavigate toFile>Preferences>Settings.

  2. On theUser tab of theSettings dialog, navigate toExtensions>Cloud Code.

  3. Scroll until you find theCloudcode: Gemini Code Assist: InlineSuggestions: Enable Auto list, and then selectOff.

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

Optional: Exclude files from context with an .aiexclude file

You can exclude files from being considered by Gemini Code Assistfor context by creating an.aiexclude file. An.aiexclude file follows thesimilar syntax as a.gitignore file, with the following differences:

  • An empty or nonexistent.aiexclude file blocks no files in its directory andall sub-directories.
  • An.aiexclude file doesn't support negation, where you prefix patterns withan exclamation point (!).
  • An.aiexclude file matches greedily on the* character. This will matchindiscriminately on directories and files. This.aiexclude file doesn'tdifferentiate between** or* with regards to folders or files.

Only a single.aiexclude file is supported currently. To configure your.aiexclude file, create a file titled.aiexclude in the root of yourworkspace folder. If you want to place this file outside of the workspace root,or rename the file, the path may be set in the VS Code settings under"Context Exclusion File". The path value provided in this setting will resolverelative to the root folder of your open workspace.

Examples

The following examples demonstrate how you can configure an.aiexclude file:

  • Block all files namedapikeys.txt at or below the workspace directory:

    apikeys.txt

  • Block all files with the.key file extension at or below the workspacedirectory:

    *.key

  • Block only the apikeys.txtfile at the same directory as the.aiexclude file,but not any subdirectories:

    /apikeys.txt

  • Block all files in the directorymy/sensitive/dir and all subdirectories.The path should be relative to the workspace root directory.

    my/sensitive/dir/*

Disable code suggestions that match cited sources

Gemini provides citation information when it directly quotes atlength from another source, such as publicly available source code.For more information, seeHow and when Gemini cites sources.

To prevent code that matches cited sources from being suggested, you can modifythegeminicodeassist.recitation.maxCitedLength setting to0 in asettings.json file:

"geminicodeassist.recitation.maxCitedLength":0

Use smart actions

To help you be more productive while minimizing context switching,Gemini Code Assist provides AI-poweredsmart actions directlyin your source code editor. When you select code in your editor, you can viewand select from a list of actions relevant to your context.

To use smart actions, follow these steps:

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

  2. Next to the selected code block, clicklightbulbShow Code Actions.

    Smart actions lightbulb icon appears after selecting a block of code in Shell and Workstations.

  3. Select an action such asGenerate unit tests.

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

Use code transformation

Gemini Code Assist providescode Transformation, which allowsyou to select a portion of code in a file and request modifications toyour existing code through prompts in natural language, using an inline textbox.

With code Transformation, you can do the following:

  • Generate comment lines to document your code
  • Troubleshoot code with issues
  • Improve code readability
  • Make code more efficient

You can also view context sources of a generated response in theGemini:Chat pane.

Prompt Gemini Code Assist with the inline text box

The inline text box allows you to interact withGemini Code Assist directly in your code.

To open the inline text box and prompt Gemini, follow thesesteps:

  1. In a source file, pressControl+I (for Windows andLinux) orCommand+I (for macOS).

  2. Enter a prompt, likeWrite a function to create a Cloud Storage bucket, andpressEnter (for Windows and Linux) orReturn (for macOS).

    Gemini Code Assist generates the code based on your prompt.

View diff of refactored code

With the diff view built into the inline text box, you can see the changes thatGemini suggests and your original code. You can then accept ordiscard the suggested changes.

To view the diff of refactored code from the inline text box, perform thefollowing steps:

  1. In a source file, select a function and open the inline text box by pressingControl+I (for Windows and Linux) orCommand+I (formacOS).

  2. Enter a prompt, likeAdd comments and pressEnter (for Windowsand Linux) orReturn (for macOS).

    When Gemini generates the code changes to your selectedfunction, the diff view appears.

    Context sources listed in the Gemini: Chat pane.

  3. To accept or discard the changes, clickAccept orDiscard.

View context sources of a generated response

The context display feature lists your project files (thecontext sources)that were used as reference to generate responses to your prompts. Knowing whichfiles were used as references helps you to refine your prompts and get morespecific responses. Context sources are shown every time you useGemini chat.

To view the context sources of the generated response, in theGemini: Chatpane, scroll until you see theContext Sources snippet. Expand the snippetto see all of the context sources.

Context sources listed in the Gemini: Chat pane.

Use smart commands

Smart commands are commands that you can use in the inline text box toperform specific actions to your code.

To get an explanation of an entire source file with the/explainsmart command, follow these steps:

  1. In a file, open the inline text box by pressingControl+I (for Windows and Linux) orCommand+I(for macOS).

  2. Press/ to view the list of smart commands and their descriptions.

  3. Select/explain.

    Gemini generates an explanation of the entire file in theinline text box.

  4. Optional: If you want to view the generated response in theGemini: Chatpane, clickView in Chat.

View prompt history

Accessing your prompt history saves you time when you want to reuse promptsin a large source file.

To access your prompt history, in your file, open the inline text box bypressingControl+I (for Windows and Linux) orCommand+I(for macOS) and then pressControl+Up arrow (for Windows and Linux)orCommand+Up arrow (for macOS). This allows you to cycle throughyour older prompts and re-use them when needed.

Enhance code readability for non-native English speakers

If you're a non-native English speaker who relies on translation applications,you can use the inline text box to generate comments in other languages.

To convert English comments to another language or add new comments in anotherlanguage, follow these steps:

  1. In a source file, select the code that you want to add comments to.

  2. Open the inline text box by pressingControl+I (for Windows andLinux) orCommand+I (for macOS).

  3. Enter a prompt, likeAdd spanish comments and pressEnter (forWindows and Linux) orReturn (for macOS).

    Gemini generates comments in the language that you specifiedin your prompt and views the diff of these suggestions.

  4. To accept or discard these changes to your code, clickAccept orDiscard.

Test other example prompts

After reading through theGenerate code with prompts section of thisdocument, try some of the following example prompts.

Get an explanation of code

  1. In a source file, select a function that you want explained.

  2. In theGemini Code Assist pane, enter the promptExplain this code to me.

    Gemini uses your selected code as a reference andresponds with an explanation of the selected function.

Generate test plans

  1. In a source file, select the code that you want to add unit testsfor.
  2. In theGemini Code Assist pane, enter the promptWrite unit tests for my code.

Get help with debugging code

  1. In a source file, select the code that you want to debug.
  2. In theGemini Code Assist pane, enter the promptHelp me debug my code.

Make your code more readable

  1. In a source file, select the code that you want to make morereadable.

  2. In theGemini Code Assist pane, enter the promptMake my code more readable.

    If you prefer to focus on a specific part of your code, then select thepreferred part of code before prompting Gemini.

Known issues

The following sections outline the known issues ofGemini Code Assist.

License recitation warnings don't persist across sessions

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

  1. ClickmenuMenu>View>Output.

  2. SelectGemini Code Assist - Citations.

Connectivity issues in the Gemini Code Assist output window

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

  • Configure your firewall to allow access tooauth2.googleapis.com andcloudaicompanion.googleapis.com.

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

You can use thegrpc-health-probe tool to test connectivity. A successfulcheck results in the following output:

$ grpc-health-probe -addr cloudaicompanion.googleapis.com:443 -tlserror: 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 beforegrpc-health-probe:

export GRPC_GO_LOG_SEVERITY_LEVEL=info

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

If youselected your project per the instructions in thisguide, which includes enabling the Gemini for Google Cloud API, then there may bean issue with the LS server.

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

  1. Next to the search bar in Cloud Shell Editor, clickchat_sparkOpen Gemini CodeAssist Chat.

  2. In theGemini Code Assist Chat pane, clickLeave Feedback.

  3. ClickShow for any of the log files to see more details and to helptroubleshoot the issue.

Leave feedback

To leave feedback of your experience, follow these steps:

  1. Next to the search bar in Cloud Shell Editor, clickchat_sparkOpen Gemini CodeAssist Chat.

  2. In theGemini Code Assist Chat pane, clickLeave Feedback.

    Gemini Code Assist feedback in Cloud Shell Editor.

  3. In theFeedback for Gemini Code Assist form, select theFeedbackcategory andType, and describe your issue in theComments field.

  4. To share your Gemini Code Assist logs, select theSend Gemini Code Assist logs options.

  5. ClickSubmit Feedback.

What's next

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-12-15 UTC.