The language server uses a compile_commands.json file to understand how each translation unit in your project is built. Compiler options, include paths, and preprocessor definitions all affect how the language server interprets your source files. This compilation database supplies the build context needed for accurate Go to Definition, Find References, and other semantic code intelligence.
Generate this file using the skill or build-system guidance below, then follow the configuration guide to point the language server at the file or use automatic discovery.
For CMake or manual MSBuild (vcxproj) setup, run the generate-compile-commands skill in GitHub Copilot CLI with a prompt like "regenerate compile commands" or "load project" to generate the file and configure the language server. The skill is included with the cpp-language-server plugin. When the automatic MSBuild configuration experiment is enabled for you, a separate skill invocation is not needed for initial setup at startup. You can still rerun the skill to refresh compile_commands.json if your project changes during the CLI session.
If you don't want to use the skill, follow the build-system guidance below.
CMake projects that use the Ninja or Makefile generators can easily create a compile_commands.json by setting the CMAKE_EXPORT_COMPILE_COMMANDS variable during configuration. For CMake projects that typically use other generators, first check if it is possible as a one-off to configure the project using the Ninja or Makefile generator, as this is the easiest way to get compile_commands.json.
Add -DCMAKE_EXPORT_COMPILE_COMMANDS=ON to your CMake configuration command.
For AI assistance with this step, try adding this skill to GitHub Copilot CLI and running it. Learn more about skills with the GitHub Copilot CLI documentation.
To set up an MSBuild-based project, supply a compile_commands.json using the skill or manual guidance below. If the automatic MSBuild configuration experiment is enabled for you on Windows, the language server can generate it instead.
Note
Automatic MSBuild configuration is disabled by default. It is available only when the experiment is enabled for you through feature flagging.
On Windows, when the experiment is enabled for you, the Microsoft C++ Language Server runs its bundled MSBuild compile commands extractor automatically during startup when compile_commands.json needs to be generated. You do not need to invoke a separate configuration skill for this initial setup.
Note
Automatic MSBuild configuration currently runs at startup, not in response to project changes during a CLI session. If your project changes during the session, use the Copilot CLI skill to regenerate compile_commands.json. File-system watching to detect these changes is planned for a future update.
The generated compilation database captures your project's compiler options, include paths, and preprocessor definitions. For example, when you ask Copilot to find a function's definition or identify its callers, the language server uses that build context to interpret the code and resolve symbol relationships.
To disable automatic configuration or change how long it can run, use the settings below. If you prefer to generate the compilation database yourself, see generating compile commands manually.
You can disable automatic MSBuild extraction or adjust its timeout in the language server's per-user state.json file on Windows. These settings apply to all repositories for that user; they do not belong in your project's cpp-lsp.json or Copilot CLI's lsp.json.
-
Close running Copilot CLI sessions that use the C++ language server.
-
Open
%LOCALAPPDATA%\mscppls\state.json. -
Add or update the following properties in the existing top-level JSON object, preserving all other properties. If the file does not exist, create its parent directory and a file containing:
{ "auto_generate_compile_commands_for_msbuild": false, "msbuild_extractor_timeout_seconds": 120 } -
Restart Copilot CLI so the language server reads the updated settings.
auto_generate_compile_commands_for_msbuild set to the JSON boolean false disables automatic MSBuild extraction. To re-enable it, set the property to true and restart the language server again. Setting this property to true does not bypass feature flagging; the experiment must also be enabled for you.
msbuild_extractor_timeout_seconds sets the timeout in seconds and applies only when automatic extraction is enabled. In the example above, automatic extraction is disabled, so the 120-second timeout has no effect until you re-enable it. Changes take effect on the next language-server startup.
Important
The state file can also contain authentication data and other user settings. Do not replace an existing file with only the example above, commit it to your repository, or attach it to a public issue.
If the experiment is not enabled for you or you disable automatic extraction, generate compile_commands.json with the Copilot CLI skill or manually.
Refer to this sample application for an example of how to generate compile_commands.json from MSBuild projects. While the sample application is designed to work out-of-the-box for many projects, it may require adaptation for complex projects.
Refer to your build system vendor's documentation.
For custom or non-standard builds, we recommend capturing the steps to generate compile_commands.json in a project-specific skill so the process is reproducible for you and your team. Once you've worked out the commands needed to produce the file, save them as a skill (for example, in your project's skills/ directory) following the GitHub Copilot CLI skills documentation. The setup-cpp-language-server skill is a good starting template to adapt.
For guidance on authoring a project-specific skill, see authoring an extractor skill.