is now available! Read about the new features and fixes from September.

Getting started with Copilot Chat in VS Code

This tutorial walks you through using the GitHub Copilot Chat extension in Visual Studio Code. You use AI-powered chat conversations to help with refactoring code, improving your code understanding, and finding your way around configuring VS Code.

If you're new to using GitHub Copilot in VS Code, see the GitHub Copilot Overview or get set up and discover the key capabilities in the GitHub Copilot Getting Started Tutorial.

Prerequisites

  • To use GitHub Copilot in VS Code, you must have the GitHub Copilot extension. When you install this extension, the GitHub Copilot Chat extension is also installed.

  • To use GitHub Copilot, you must have an active subscription for GitHub Copilot in your personal account, or you need to be assigned a seat by your organization.

Follow these steps to set up GitHub Copilot in VS Code by signing up for a subscription and installing the Copilot extension in VS Code.

Get your first Copilot chat conversation

Copilot Chat is a chat interface that lets you interact with GitHub Copilot, to ask and receive answers to coding-related questions. The chat interface provides access to coding information and support without requiring you to navigate documentation or search online forums.

In this tutorial, you'll be creating a simple Node.js web application. So, let's get started and ask Copilot to tell us more about web frameworks for Node.js.

  1. Open the Chat view from the Activity Bar or press ⌃⌘I (Windows, Linux Ctrl+Alt+I).

    Screenshot of VS Code editor, showing the Copilot Chat view, highlighting the chat control in the Activity bar.

    Tip: You can drag the Chat view to the Secondary side bar to keep the Chat view and Explorer view open at the same time. Learn about custom layouts and the Secondary side bar.

  2. In the chat input field, enter give a list of nodejs web server frameworks, and then press Enter to send the request to Copilot.

    Copilot returns a list of web frameworks and with some additional information. So, you can search for coding information while you stay in VS Code.

    Note that your results might be different from what is shown in the screenshots. AI models are non-deterministic, which means that they can return different responses when asked the same question. This might be due to additional learning and adaption over time, language variation, changes in context, such as your chat history, and more.

    Screenshot of VS Code, showing the Copilot Chat view, showing the chat response and a suggested follow-up question.

    Notice that Copilot also suggests relevant follow-up questions, which you can select to directly submit directly to Copilot.

    Tip: To get help about GitHub Copilot and how to interact with Copilot Chat, you can type /help in the chat input field.

  3. Let's get more information about Express.js. Enter how to get started with express in the chat input field.

    The response contains step-by-step instructions for setting up an Express.js app and might also include code blocks with shell commands or implementation code. Code blocks in the chat response support IntelliSense, which enables you get information about methods and symbols by hovering over them, or to go to their definition.

    Screenshot of VS Code Copilot Chat view, showing the chat response with code blocks in the response.

    When Copilot returns a code block, you can select the Apply in Editor button to let Copilot insert the code in the active editor for you at the appropriate location. Alternatively, you can also insert the code at the cursor position, or copy the code to the clipboard.

    Screenshot of VS Code Copilot Chat view, showing the context menu for code blocks.

    When the chat response contains links to a file, you can drag and drop that file from the Chat view to the editor to open it.

    Tip: Experiment with different questions and see how Copilot responds. For example, you can ask for only code samples ("give me 3 code samples to create an express app"), or ask how to add basic authentication to an Express app ("how to create an express app with basic auth"), and much more!

Generate a new workspace

Even to create a simple Express.js application involves creating multiple files: a JavaScript file to set up the server, a package.json, HTML (template) files, and more. Rather than asking Copilot to generate each individual file, you can instruct it to create an entire workspace for you.

Let's ask Copilot to generate a workspace for an Express.js and Pug application.

  1. Enter @workspace /new express with typescript and pug in the chat input field, and press Enter to send the request.

    Notice how this chat prompt is structured to provide clear and concise instructions to Copilot. Let's break it down:

    • @workspace is a chat participant, which are domain experts that can perform tasks or answer questions in a specific domain. In this case, @workspace knows about VS Code workspaces and your codebase.

    • /new is a slash command that tells the @workspace participant that you want to create a new workspace. Slash commands are a shorthand for commonly used instructions. You can enter the / symbol in the chat input to get the list of supported commands.

  2. Copilot returns a file tree that represents the new workspace files, and a button to create the workspace.

    Screenshot of VS Code Copilot Chat view, showing a file tree for a new workspace and a 'Create workspace' button.

    You can select any file in the file tree to preview the content before it's actually created. If you're not happy with the generated files, or want something different, you can ask follow-up questions, like @workspace use ejs to use EJS instead of Pug.

  3. Select Create workspace to create a new workspace and select a folder on disk where the workspace should be created.

    When the workspace creation finishes, VS Code reloads with the new workspace.

    Screenshot of VS Code, showing the newly created workspace for an Express app.

Congratulations! You've just created a workspace with Copilot Chat by using natural language. The advantage of this approach is that you tweak your request as you like. Maybe you prefer using Express.js with EJS, or not use Express.js at all and use plain Node.js with Bootstrap. Choose what you prefer most!

Use chat participants

Previously, you already used the @workspace chat participant to generate a new workspace, but you can also use it to ask questions about the actual code in the workspace.

Let's iterate on our generated Express app and add a new page to it.

  1. In the Chat view, enter the @workspace how to add a new page?

    Screenshot of VS Code Copilot Chat view, showing the results for added a page.

    Copilot returns step-by-step instructions for adding a new page that are specific to your code. This is because you added @workspace in the chat prompt, which has the context about your specific workspace contents. If you wouldn't include @workspace, you would get more generic instructions.

  2. Optionally, follow the instructions and add a new page to your app.

    Tip: You can add more details about the type of page you want to add, such as a home page, a contact page, or a product page.

  3. There are more chat participants that you can use, each with its own domain-specific expertise. Select the icon or just type @ in the Chat view to get the list of available chat participants.

    Screenshot of VS Code Copilot Chat view, showing the list of chat participants.

    Note: Extensions can also contribute chat participants, so the list might vary based on the extensions you have installed in VS Code.

  4. Let's use @vscode to ask about VS Code. Enter @vscode how to debug node.js app in the chat input field.

    You get instructions about how to debug a Node.js app in VS Code, and also get a button to directly access the corresponding VS Code functionality.

    Screenshot of VS Code Copilot Chat view, showing results and a button to open the Command Palette in VS Code.

Stay in the flow with inline chat

While the Chat view is great for keeping a conversation going with Copilot, having access to chat directly from the editor might be more efficient for particular scenarios. For example, when you're reviewing code changes, writing unit tests, or refactoring code.

Let's look at how to use chat for code refactoring.

  1. Open the app.ts file in the editor and put the cursor on the line where the port number is set (const port = 3000).

    For more complex code changes, you can select a block of code to provide more context to Copilot about what you want to change.

  2. Press ⌘I (Windows, Linux Ctrl+I) on your keyboard to bring up Copilot inline chat, or right-click and select Copilot > Start in Editor.

    Copilot inline chat enables you to ask questions to Copilot directly from the editor.

    Screenshot of VS Code editor, highlighting the inline chat popup control.

    Let's now ask Copilot to refactor the code to make the port number configurable.

  3. Enter make configurable in the chat input field and press Enter.

    Notice how Copilot updates the selected code and suggests reading the port number from an environment variable.

    Screenshot of VS Code editor with the suggested code change.

    You can view the applied changes by selecting More Actions > Toggle Changes.

    Screenshot of VS Code inline chat, highlighting the 'More Actions' control and diff editor.

  4. Select Accept or Discard to apply or ignore the changes.

    If you're not happy with the suggested code changes, you can select the Rerun Request button to get another suggestion.

    Tip: Use the thumbs up and thumbs down buttons to provide feedback to Copilot about the suggestions.

Congratulations on using Copilot inline chat in the editor to help you with code refactoring!

Use smart actions

There are some common scenarios where you might invoke Copilot directly, without having to enter a chat prompt. For example, Copilot can help with adding code documentation, generating unit tests, or help you fix coding errors.

Let's see how to use smart actions to fix a coding error.

  1. Open the app.ts file and select one of the symbols that has a red squiggle.

  2. Select the sparkle icon to view the Copilot code actions, and then select Fix using Copilot.

    Screenshot of VS Code, highlighting the sparkle and Copilot smart actions context menu.

  3. Copilot inline chat comes up, prepopulated with the error message, and a suggestion to resolve the problem.

    Screenshot of VS Code inline chat, showing the result of the fix smart action.

    Notice how Copilot uses the /fix slash command, followed by the error message. You can also use the /fix command directly in the chat input field to get help with fixing coding errors.

In addition to Fix, Copilot provides more smart code actions, such as Explain (/explain), Generate Docs (/doc), and Generate Tests (/tests). You can access these actions via the editor context menu and then selecting Copilot.

Screenshot of VS Code Copilot smart action context menu.

And if you come across some block of code that's unclear, just select it and use /explain to get Copilot to give you an explanation and help improve your code understanding.

Add chat context

Previously, you used @workspace to ask questions about your workspace. What if you want to ask Copilot a question about something specific, maybe a particular file or a symbol in your code? How can you provide that context to Copilot without having to describe everything extensively in natural language?

Let's ask Copilot about what the purpose of a specific file in the workspace is.

  1. Open the Chat view from the Activity Bar or press ⌃⌘I (Windows, Linux Ctrl+Alt+I).

  2. Select the Attach Context button next to the chat input field to open the context Quick Pick.

    Screenshot of VS Code Copilot Chat view, showing the Attach context button and context Quick Pick.

    In the context Quick Pick, you can select different types of context to add to your chat prompt, such as a file from your workspace, a symbol, the current selection, and more.

  3. Start typing index.ts to find the corresponding file, and then select the src\types\index.ts file.

    Screenshot of VS Code context Quick Pick, highlighting the selected' index.ts' file.

    After you select the file, notice that the file is added in the Chat view. Optionally, you can add more files or other context types to your chat prompt.

  4. Now enter the following prompt in the chat input field: @workspace what does this do. Then, press Enter to send the request.

    Screenshot of VS Code Copilot Chat view, showing the chat prompt with the attached file context.

    Copilot now returns an explanation about the purpose of the code in the selected file.

  5. Instead of using the Attach Context control, you can also directly reference the different types of context by typing # in the chat input field.

    To quickly attach a file as context for your chat prompt, you can drag and drop a file from the Explorer view onto the Chat view. If the file is open in the editor, you can also drag and drop the editor tab onto the Chat view to attach the file.

    Screenshot of VS Code Copilot Chat view, showing it as a drag and drop target for attaching a file as context.

Congratulations

Congratulations, you successfully used the GitHub Copilot Chat extension to have AI-powered conversations to help refactor your code, fix problems, or improve your code understanding.

Additional resources