GitHub Copilot in VS Code settings reference

This article lists the configuration settings for GitHub Copilot in Visual Studio Code. For general information about working with settings in VS Code, refer to User and workspace settings, as well as the Variables reference for information about predefined variable support.

The team is continuously working on improving Copilot in VS Code and adding new features. Some features are still experimental. Try them out and share your feedback in our issues. Get more info about the feature lifecycle in VS Code.

General settings

• github.copilot.editor.enableAutoCompletions: Automatically show inline completions.
• github.copilot.enable: Enable or disable Copilot completions for specified languages.
• github.copilot.editor.enableCodeActions: Controls if Copilot commands are shown as Code Actions when available.
• github.copilot.renameSuggestions.triggerAutomatically: Controls whether Copilot generates suggestions for renaming.
• chat.commandCenter.enabled: Controls whether to show the Copilot menu in the VS Code title bar (default: true).
• github.copilot.nextEditSuggestions.enabled: Enables Copilot Next Edit Suggestions (Copilot NES).
• editor.inlineSuggest.edits.allowCodeShifting: Configure if Copilot NES is able to shift your code to show a suggestion.
• editor.inlineSuggest.edits.renderSideBySide: Configure if Copilot NES can show larger suggestions side-by-side if possible, or if Copilot NES should always show larger suggestions below the relevant code.
• workbench.commandPalette.experimental.askChatLocation (Experimental): Controls where the Command Palette should ask chat questions.
• github.copilot.chat.search.semanticTextResults (Experimental): Enables semantic search results in the Search view.
• chat.setupFromDialog (Experimental): Controls whether to show the Copilot setup dialog when starting a chat session.

Chat settings

• github.copilot.chat.followUps: Controls whether Copilot should suggest follow-up questions in chat.
• github.copilot.chat.localeOverride: Specify a locale that Copilot should respond in, such as en or fr.
• github.copilot.chat.runCommand.enabled: Enables the /runCommand intent in the Chat view to run VS Code commands.
• github.copilot.chat.useProjectTemplates: Use relevant GitHub projects as starter projects when using /new.
• github.copilot.chat.scopeSelection: Whether to prompt for a specific symbol scope if you use /explain and the active editor has no selection.
• github.copilot.chat.terminalChatLocation: Controls where chat queries from the terminal should be opened.
• chat.detectParticipant.enabled: Enable chat participant detection in the Chat view.
• chat.editor.fontFamily: Font family in chat codeblocks.
• chat.editor.fontSize: Font size in pixels in chat codeblocks.
• chat.editor.fontWeight: Font weight in chat codeblocks.
• chat.editor.lineHeight: Line height in pixels in chat codeblocks.
• chat.editor.wordWrap: Toggle line wrapping in chat codeblocks.
• chat.editing.confirmEditRequestRemoval: Ask for confirmation before undoing an edit (default: true)
• chat.editing.confirmEditRequestRetry: Ask for confirmation before performing a redo of the last edit (default: true)
• chat.editing.autoAcceptDelay: Configure a delay after which suggested edits are automatically accepted, use zero to disable auto-accept (default: 0)
• chat.agent.enabled: Enable or disable agent mode (default: false, requires VS Code 1.99 or later)
• chat.agent.maxRequests: Maximum number of requests that Copilot can make in agent mode (default: 15)
• github.copilot.chat.agent.runTasks: Run workspace tasks when using agent mode (default: true)
• github.copilot.chat.codesearch.enabled (Preview): When using #codebase in the prompt, Copilot automatically discovers relevant files to be edited.
• chat.implicitContext.enabled (Experimental): Configure if the active editor should be automatically added as context to the chat prompt.
• github.copilot.chat.agent.thinkingTool (Experimental): Enable the thinking tool in agent mode.
• github.copilot.chat.newWorkspaceCreation.enabled (Experimental): Enable the agent mode tool for scaffolding a new workspace in chat.
• github.copilot.chat.edits.temporalContext.enabled (Experimental): Whether to include recently viewed and edited files with requests in Copilot Edits.
• github.copilot.chat.edits.suggestRelatedFilesFromGitHistory (Experimental): Suggest related files from git history in Copilot Edits (default: false)

Inline chat settings

• inlineChat.acceptedOrDiscardBeforeSave: Controls whether pending Inline Chat sessions in an editor prevent saving the file.
• inlineChat.finishOnType: Whether to finish an Inline Chat session when typing outside of changed regions.
• inlineChat.holdToSpeech: Whether holding the Inline Chat keyboard shortcut will automatically enable speech recognition.
• inlineChat.lineEmptyHint (Experimental): Controls whether to show a hint for Inline Chat on an empty line.
• inlineChat.lineNaturalLanguageHint (Experimental): Experimental suggestion that triggers Inline Chat as soon as a line mostly consists of words.
• editor.inlineSuggest.syntaxHighlightingEnabled: Controls whether to show syntax highlighting for inline suggestions.
• github.copilot.chat.editor.temporalContext.enabled (Experimental): Whether to include recently viewed and edited files with Copilot requests in Inline Chat.

Customize Copilot prompts

• github.copilot.chat.codeGeneration.useInstructionFiles: Controls whether code instructions from .github/copilot-instructions.md are added to Copilot requests.
• github.copilot.chat.reviewSelection.enabled (Preview): Enable code review for an editor text selection.
• github.copilot.chat.reviewSelection.instructions (Preview): A set of instructions that will be added to Copilot requests for reviewing the current editor selection.
• github.copilot.chat.codeGeneration.instructions (Experimental): A set of instructions that will be added to Copilot requests that generate code.
• github.copilot.chat.testGeneration.instructions (Experimental): A set of instructions that will be added to Copilot requests that generate tests.
• github.copilot.chat.commitMessageGeneration.instructions (Experimental): A set of instructions that will be added to Copilot requests that generate commit messages. Copilot requests for reviewing the current editor selection.
• github.copilot.chat.pullRequestDescriptionGeneration.instructions (Experimental): A set of instructions that will be added to Copilot requests that generate pull request titles and descriptions.
• chat.promptFiles (Experimental): Enable or disable reusable prompt files.
• chat.promptFilesLocations (Experimental): Specify the location of prompt files. Set to true to use the default location (.github/prompts), or use the { "/path/to/folder": boolean } notation to specify a different path. Relative paths are resolved from the root folder(s) of your workspace.

Debugging settings

• github.copilot.chat.startDebugging.enabled (Preview): Enables the experimental /startDebugging intent in the Chat view to generate debugging configuration.
• github.copilot.chat.copilotDebugCommand.enabled (Preview): Enables the copilot-debug terminal command.

Testing settings

• github.copilot.chat.generateTests.codeLens (Experimental): Show Generate tests code lens for symbols that are not covered by current test coverage information.
• github.copilot.chat.setupTests.enabled (Experimental): Enables the experimental /setupTests intent and prompting in /tests generation.
• github.copilot.chat.testGeneration.instructions (Experimental): A set of instructions that will be added to Copilot requests that generate tests.

Notebook settings

• notebook.experimental.generate (Experimental): Enable the Generate action to create code cells with Inline Chat enabled in the notebook editor.

Accessibility settings

• inlineChat.accessibleDiffView: Whether the Inline Chat also renders an accessible diff viewer for its changes.
• accessibility.signals.chatRequestSent: Plays a signal - sound (audio cue) and/or announcement (alert) - when a chat request is made.
• accessibility.signals.chatResponseReceived: Plays a sound / audio cue when the response has been received.
• accessibility.verbosity.inlineChat: Provide information about how to access the inline editor chat accessibility help menu and alert with hints that describe how to use the feature when the input is focused.
• accessibility.verbosity.inlineCompletions: Provide information about how to access the inline completions hover and Accessible View.
• accessibility.verbosity.panelChat: Provide information about how to access the chat help menu when the chat input is focused.
• accessibility.voice.keywordActivation: Controls whether the keyword phrase 'Hey Code' is recognized to start a voice chat session.
• accessibility.voice.autoSynthesize: Controls whether a textual response should automatically be read out aloud when speech was used as input.
• accessibility.voice.speechTimeout: The duration in milliseconds that voice speech recognition remains active after you stop speaking.

Related resources

• Get a quick overview of the Copilot features in VS Code